Clean document whitespace

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.

text · Operation ID: whitespace-clean

Choose this operation when

Apply explicit line separator and ASCII whitespace cleanup.

Outside this profile

Preserving all indentation-sensitive semantics automatically.

Exact release references

Static JSON contract · Markdown reference · Fixed example response

Complete input 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
}

Complete output-envelope 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
}

Fixed example

One accepted fixed example, not a custom-input trial. No operation runs when this static page is requested.

Example input

{
  "text": "  Keep indent  \r\n\r\n\r\nNext\t  word \r\n",
  "collapseHorizontalWhitespace": true,
  "maxBlankLines": 1
}

Example response

{
  "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
  }
}

Bounds and precision

JavaScript IEEE-754 numbers; use strings for large integer IDs/exact decimals where the schema accepts strings. No lossless numeric parsing.

{
  "global": {
    "requestBytes": 131072,
    "responseBytes": 524288,
    "jsonDepth": 32,
    "jsonNodes": 20000,
    "requestsPerMinute": 60,
    "paidAttemptsPerMinute": 20,
    "idempotencyHours": 24
  },
  "operation": {
    "requestBytes": 131072,
    "responseBytes": 524288,
    "jsonDepth": 32
  }
}

Complete schemas, descriptions and cross-field validation may impose additional limits.

Proposed price and protocol definitions

{
  "unit": "one successful operation call",
  "proposedNominalUsd": "0.003",
  "sixDecimalTokenBaseUnits": "3000",
  "subscription": false,
  "includesPayerWalletOrNetworkFees": false,
  "liveQuoteVerified": false,
  "condition": "Actual SDK challenge is authoritative only within the caller's explicit authorization; configured six-decimal token peg is an operator assertion, not a conversion guarantee."
}

Protocol definitions: x402, mpp. MPP uses Tempo charge. Paid MCP execution is unsupported. All runtime readiness is not evaluated in this build.

API path templates, not endpoints on this documentation host

{
  "x402": "/v1/x402/whitespace-clean",
  "mpp": "/v1/mpp/whitespace-clean"
}

Required headers

{
  "Content-Type": "application/json",
  "Idempotency-Key": "random 16–128 character operation identifier"
}

Actual SDK challenge amount, asset, network, recipient and wallet costs must pass independent authorization. Preserve identical key, body, protocol and credential on retries; on PAYMENT_UNCERTAIN stop and reconcile.

Execution profile and provider conditions

{
  "deterministic": true,
  "externalRequests": 0,
  "maxExternalRequests": 0,
  "resultSnapshotPersisted": false,
  "fixedExampleIsIllustrativeSnapshot": false,
  "requiresPayment": true,
  "supportsMcpExecution": false
}

Deterministic supplied-input operation with no external requests or stored request/result bodies. Payment infrastructure retains payment metadata and hashes.

Failure handling

HTTP 400: Malformed JSON, missing/invalid idempotency key, or payment identifier mismatch Correct the request before payment
HTTP 402: Payment challenge or rejected payment Use official protocol SDK; inspect payment outcome before another payment
HTTP 409: Idempotency conflict, duplicate proof, or PAYMENT_UNCERTAIN Keep original key, body, and proof; reconcile uncertainty with operator; never blindly repay
HTTP 413: Input or generated output too large Reduce input; no payment attempted for validation failure
HTTP 415: Unsupported media type or compression Send uncompressed application/json
HTTP 422: Schema or service-specific semantic validation failure Correct input using returned error code; no payment attempted
HTTP 429: Request/payment-attempt rate exceeded Wait for rate limit window; preserve existing payment identity
HTTP 503: Payment configuration/provider/state unavailable, or live DNS preparation failed before settlement Check readiness; DNS preparation failures may retry the identical key/body/credential only; uncertainty requires reconciliation

Declared requirements

Before any paid call, refresh the live operation contract and POST the complete bounded budgeted plan to the separate API's /preflight. Unknown requirements block selection; compatible preflight is not permission to spend.