{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/creative/list-transformers-request.json",
  "title": "List Transformers Request (Creative Agent)",
  "description": "Request parameters for discovering account-scoped creative transformers offered by this creative agent. Brief-filterable and paginated. Transformers are the creative analog of media-buy products: agent-offered, account-scoped, selectable units of build capability. Use `expand_params` to additionally return account-scoped option VALUES (e.g. the buyer's configured voices) for named enumerable params.",
  "x-tool-summary": "Discover account-scoped creative transformers and their selectable configuration options.",
  "type": "object",
  "allOf": [
    {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/version-envelope.json"
    },
    {
      "if": {
        "properties": {
          "include_pricing": {
            "const": true
          }
        },
        "required": [
          "include_pricing"
        ]
      },
      "then": {
        "required": [
          "account"
        ]
      }
    }
  ],
  "properties": {
    "transformer_ids": {
      "type": "array",
      "description": "Return only these specific transformer IDs.",
      "items": {
        "type": "string",
        "x-entity": "transformer"
      },
      "minItems": 1
    },
    "input_format_ids": {
      "type": "array",
      "deprecated": true,
      "description": "**DEPRECATED in 3.2.** Filter by legacy named input formats. Use input_format_kinds.",
      "items": {
        "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/format-id.json"
      },
      "minItems": 1
    },
    "output_format_ids": {
      "type": "array",
      "deprecated": true,
      "description": "**DEPRECATED in 3.2.** Filter by legacy named output formats. Use output_capability_ids.",
      "items": {
        "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/format-id.json"
      },
      "minItems": 1
    },
    "input_format_kinds": {
      "type": "array",
      "description": "Filter to transformers whose canonical input_formats include any of these canonical format kinds.",
      "items": {
        "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/canonical-format-kind.json"
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "output_capability_ids": {
      "type": "array",
      "description": "Filter to transformers that can produce any of these canonical creative.supported_formats capability IDs.",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z0-9_-]+$"
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "name_search": {
      "type": "string",
      "description": "Search transformers by name (case-insensitive partial match)."
    },
    "brief": {
      "type": "string",
      "description": "Natural-language brief used to rank and filter transformers (and their enumerable option values when expanded) — e.g. 'warm female Spanish-language voiceover'. Curates to intent rather than returning the full set, the way get_products curates inventory."
    },
    "expand_params": {
      "type": "array",
      "description": "Param `field` names for which to return the FIRST page of account-scoped option VALUES inline on each transformer's `params[].options[]`. Omit to return param descriptors without enumerated values (the lean default). When a param's options are truncated, its `params[].options_cursor` is set — fetch the next page via `expand_pagination` (below).",
      "items": {
        "type": "string"
      },
      "minItems": 1
    },
    "expand_pagination": {
      "type": "array",
      "description": "Fetch the NEXT page of a specific param's account-scoped options, using the `options_cursor` a prior response returned for that `(transformer, param)`. Scoped per `(transformer_id, field)` so multiple params can be paged independently. Use this instead of `expand_params` once you hold a cursor.",
      "items": {
        "type": "object",
        "properties": {
          "transformer_id": {
            "type": "string",
            "x-entity": "transformer",
            "description": "The transformer whose param options to page."
          },
          "field": {
            "type": "string",
            "description": "The param `field` to page."
          },
          "options_cursor": {
            "type": "string",
            "description": "Opaque cursor from that param's prior `params[].options_cursor`."
          }
        },
        "required": [
          "transformer_id",
          "field",
          "options_cursor"
        ],
        "additionalProperties": true
      },
      "minItems": 1
    },
    "include_pricing": {
      "type": "boolean",
      "default": false,
      "description": "Include `pricing_options` on each transformer. Requires `account`."
    },
    "account": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/account-ref.json",
      "description": "Account reference. Transformers are account-scoped — the returned set, the enumerable option values, and (with include_pricing) the rate card are all resolved for this credential."
    },
    "pagination": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/pagination-request.json"
    },
    "context": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/context.json"
    },
    "ext": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.0/core/ext.json"
    }
  },
  "additionalProperties": true
}