Added value: +{
+  "description": "Optional sourced platform rule profile id. The profile is returned beside the QA report for agent audit trails.",
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"Local source image files to upload through the browser file input. Maximum paid batch size is 50."New value: +"Local source image files to upload through the browser file input. Agent batches up to 5 files are free; the paid batch limit is 50."

Previous value: -"Optional x402 unlock token for paid agent batch/scenario runs. Obtain it outside this adapter."New value: +"Optional x402 unlock token for paid agent batch/scenario runs above 5 files. Obtain it outside this adapter."

Previous value: -"Optional x402 unlock token for paid agent batch/scenario runs."New value: +"Optional x402 unlock token for paid agent batch/scenario runs above 5 files."

Added value: +"Optional QuokkaPix site base URL. Defaults to https://quokkapix.com."

Added value: +"Optional QuokkaPix site base URL. Defaults to https://quokkapix.com."

Added value: +"Recipe id from list_recipes, for example shopify_product_pack, amazon_product_batch or metadata_clean_batch."

Added value: +"Optional QuokkaPix app URL. Defaults to https://quokkapix.com/#agent=1. For safety, only quokkapix.com, localhost and 127.0.0.1 are accepted unless QUOKKAPIX_ALLOW_CUSTOM_APP_URL=1 is set."

Added value: +"Optional local image file for QuokkaPix background replacement workflows."

Added value: +"Run Chromium headless. Defaults to true unless debugging."

Added value: +"Local source image files to upload through the browser file input. Maximum paid batch size is 50."

Added value: +"Absolute or client-relative local file path readable by the MCP process. Do not pass remote URLs here."

Added value: +"Local directory where the adapter writes the downloaded output and quokkapix-result.json."

Added value: +"Custom recipe object. Provide either recipeId or recipe."

Added value: +{
+  "applySettings": {
+    "additionalProperties": {},
+    "description": "QuokkaPix settings applied before processing starts.",
+    "properties": {
+      "mode": {
+        "description": "Use single for one image or batch for multiple images.",
+        "enum": [
+          "single",
+          "batch"
+        ],
+        "type": "string"
+      },
+      "steps": {
+        "description": "Optional ordered scenario steps. Prefer [{ tool, settings }] for custom multi-step workflows.",
+        "items": {
+          "anyOf": [
+            {
+              "description": "Simple QuokkaPix tool id step, for example resize, background, compress or watermark.",
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "description": "Structured scenario step with a tool id and per-step settings.",
+              "properties": {
+                "settings": {
+                  "additionalProperties": {},
+                  "description": "Settings for this step using the same keys accepted by window.QuokkaPixAgent.applySettings.",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                "tool": {
+                  "description": "QuokkaPix tool id for this scenario step, for example resize, background, compress or watermark.",
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "tool"
+              ],
+              "type": "object"
+            }
+          ],
+          "description": "One step in a QuokkaPix scenario workflow."
+        },
+        "type": "array"
+      },
+      "tool": {
+        "description": "QuokkaPix editor tool id, such as resize, crop, rotate, convert, compress, metadata, background, watermark, effects, rename, pdf, favicon or constructor.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "description": {
+    "description": "Short explanation of what the recipe prepares.",
+    "type": "string"
+  },
+  "expectedResult": {
+    "additionalProperties": {},
+    "description": "Expected output and QA contract.",
+    "properties": {
+      "output": {
+        "description": "Expected output type, for example zip, image, pdf or json.",
+        "type": "string"
+      },
+      "qa": {
+        "additionalProperties": {},
+        "description": "Machine-readable QA checks for the result manifest.",
+        "properties": {
+          "allowedFormats": {
+            "description": "Allowed output formats for every manifest output entry.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "expectedFormat": {
+            "description": "Required output format, for example webp, jpg, png, pdf or zip.",
+            "type": "string"
+          },
+          "expectedHeight": {
+            "description": "Exact expected output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "expectedMinOutputs": {
+            "description": "Minimum number of output entries expected.",
+            "maximum": 9007199254740991,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedOutputKind": {
+            "description": "Expected high-level output kind for QA checks.",
+            "enum": [
+              "single",
+              "batch",
+              "zip",
+              "pdf",
+              "metadata-report",
+              "icon-pack"
+            ],
+            "type": "string"
+          },
+          "expectedWidth": {
+            "description": "Exact expected output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "marketplace": {
+            "description": "Marketplace profile name used for human-readable QA context.",
+            "enum": [
+              "shopify",
+              "amazon",
+              "google-merchant"
+            ],
+            "type": "string"
+          },
+          "maxHeight": {
+            "description": "Maximum allowed output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "maxOutputKB": {
+            "description": "Recommended maximum output size per non-archive file.",
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          "maxWidth": {
+            "description": "Maximum allowed output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minHeight": {
+            "description": "Minimum recommended output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minWidth": {
+            "description": "Minimum recommended output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "requireSquare": {
+            "description": "Require square output dimensions when true.",
+            "type": "boolean"
+          },
+          "visualChecks": {
+            "description": "Visual checks requested by a recipe. Current validator reports these as metadata-only limitations.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "id": {
+    "description": "Stable recipe id, for example shopify_product_pack.",
+    "minLength": 1,
+    "type": "string"
+  },
+  "requires": {
+    "additionalProperties": {},
+    "description": "Recipe requirements such as maxFiles and payment policy.",
+    "properties": {
+      "maxFiles": {
+        "description": "Maximum files allowed by this recipe.",
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "payment": {
+        "description": "Whether the recipe normally needs a paid batch/scenario unlock.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "title": {
+    "description": "Human-readable recipe title.",
+    "type": "string"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +[
+  "id",
+  "applySettings"
+]

Added value: +"Official recipe id from list_recipes. Provide either recipeId or recipe."

Added value: +"Maximum processing timeout in milliseconds. Use a larger value for background AI or large batches."

Added value: +"Optional x402 unlock token for paid agent batch/scenario runs. Obtain it outside this adapter."

Added value: +"Optional local logo/image file for QuokkaPix logo watermark workflows."

Added value: +"Optional QuokkaPix app URL. Defaults to https://quokkapix.com/#agent=1. For safety, only quokkapix.com, localhost and 127.0.0.1 are accepted unless QUOKKAPIX_ALLOW_CUSTOM_APP_URL=1 is set."

Added value: +"Optional local image file for background replacement settings."

Added value: +"Optional QA contract used to validate quokkapix-result.json after processing."

Added value: +{
+  "allowedFormats": {
+    "description": "Allowed output formats for every manifest output entry.",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "expectedFormat": {
+    "description": "Required output format, for example webp, jpg, png, pdf or zip.",
+    "type": "string"
+  },
+  "expectedHeight": {
+    "description": "Exact expected output height in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "expectedMinOutputs": {
+    "description": "Minimum number of output entries expected.",
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "expectedOutputKind": {
+    "description": "Expected high-level output kind for QA checks.",
+    "enum": [
+      "single",
+      "batch",
+      "zip",
+      "pdf",
+      "metadata-report",
+      "icon-pack"
+    ],
+    "type": "string"
+  },
+  "expectedWidth": {
+    "description": "Exact expected output width in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "marketplace": {
+    "description": "Marketplace profile name used for human-readable QA context.",
+    "enum": [
+      "shopify",
+      "amazon",
+      "google-merchant"
+    ],
+    "type": "string"
+  },
+  "maxHeight": {
+    "description": "Maximum allowed output height in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "maxOutputKB": {
+    "description": "Recommended maximum output size per non-archive file.",
+    "exclusiveMinimum": 0,
+    "type": "number"
+  },
+  "maxWidth": {
+    "description": "Maximum allowed output width in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "minHeight": {
+    "description": "Minimum recommended output height in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "minWidth": {
+    "description": "Minimum recommended output width in pixels.",
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "requireSquare": {
+    "description": "Require square output dimensions when true.",
+    "type": "boolean"
+  },
+  "visualChecks": {
+    "description": "Visual checks requested by a recipe. Current validator reports these as metadata-only limitations.",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +"Run Chromium headless. Defaults to true unless debugging."

Added value: +"Local source image files to upload through the browser file input."

Added value: +"Absolute or client-relative local file path readable by the MCP process. Do not pass remote URLs here."

Added value: +"Maximum allowed input files for this direct settings run. Defaults to the selected files count."

Added value: +"Local directory where the adapter writes the downloaded output and quokkapix-result.json."

Added value: +"Payload accepted by window.QuokkaPixAgent.applySettings. Extra editor-specific keys are allowed."

Added value: +{
+  "mode": {
+    "description": "Use single for one image or batch for multiple images.",
+    "enum": [
+      "single",
+      "batch"
+    ],
+    "type": "string"
+  },
+  "steps": {
+    "description": "Optional ordered scenario steps. Prefer [{ tool, settings }] for custom multi-step workflows.",
+    "items": {
+      "anyOf": [
+        {
+          "description": "Simple QuokkaPix tool id step, for example resize, background, compress or watermark.",
+          "minLength": 1,
+          "type": "string"
+        },
+        {
+          "description": "Structured scenario step with a tool id and per-step settings.",
+          "properties": {
+            "settings": {
+              "additionalProperties": {},
+              "description": "Settings for this step using the same keys accepted by window.QuokkaPixAgent.applySettings.",
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "tool": {
+              "description": "QuokkaPix tool id for this scenario step, for example resize, background, compress or watermark.",
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool"
+          ],
+          "type": "object"
+        }
+      ],
+      "description": "One step in a QuokkaPix scenario workflow."
+    },
+    "type": "array"
+  },
+  "tool": {
+    "description": "QuokkaPix editor tool id, such as resize, crop, rotate, convert, compress, metadata, background, watermark, effects, rename, pdf, favicon or constructor.",
+    "minLength": 1,
+    "type": "string"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +"Optional id/name for this generated settings workflow, used in returned metadata and QA profile."

Added value: +"Maximum processing timeout in milliseconds."

Added value: +"Optional x402 unlock token for paid agent batch/scenario runs."

Added value: +"Optional local logo/image file for logo watermark settings."

Added value: +"Custom QuokkaPix recipe object. Use validate_recipe before process_images when generating this dynamically."

Added value: +{
+  "applySettings": {
+    "additionalProperties": {},
+    "description": "QuokkaPix settings applied before processing starts.",
+    "properties": {
+      "mode": {
+        "description": "Use single for one image or batch for multiple images.",
+        "enum": [
+          "single",
+          "batch"
+        ],
+        "type": "string"
+      },
+      "steps": {
+        "description": "Optional ordered scenario steps. Prefer [{ tool, settings }] for custom multi-step workflows.",
+        "items": {
+          "anyOf": [
+            {
+              "description": "Simple QuokkaPix tool id step, for example resize, background, compress or watermark.",
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "description": "Structured scenario step with a tool id and per-step settings.",
+              "properties": {
+                "settings": {
+                  "additionalProperties": {},
+                  "description": "Settings for this step using the same keys accepted by window.QuokkaPixAgent.applySettings.",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                "tool": {
+                  "description": "QuokkaPix tool id for this scenario step, for example resize, background, compress or watermark.",
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "tool"
+              ],
+              "type": "object"
+            }
+          ],
+          "description": "One step in a QuokkaPix scenario workflow."
+        },
+        "type": "array"
+      },
+      "tool": {
+        "description": "QuokkaPix editor tool id, such as resize, crop, rotate, convert, compress, metadata, background, watermark, effects, rename, pdf, favicon or constructor.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "description": {
+    "description": "Short explanation of what the recipe prepares.",
+    "type": "string"
+  },
+  "expectedResult": {
+    "additionalProperties": {},
+    "description": "Expected output and QA contract.",
+    "properties": {
+      "output": {
+        "description": "Expected output type, for example zip, image, pdf or json.",
+        "type": "string"
+      },
+      "qa": {
+        "additionalProperties": {},
+        "description": "Machine-readable QA checks for the result manifest.",
+        "properties": {
+          "allowedFormats": {
+            "description": "Allowed output formats for every manifest output entry.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "expectedFormat": {
+            "description": "Required output format, for example webp, jpg, png, pdf or zip.",
+            "type": "string"
+          },
+          "expectedHeight": {
+            "description": "Exact expected output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "expectedMinOutputs": {
+            "description": "Minimum number of output entries expected.",
+            "maximum": 9007199254740991,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedOutputKind": {
+            "description": "Expected high-level output kind for QA checks.",
+            "enum": [
+              "single",
+              "batch",
+              "zip",
+              "pdf",
+              "metadata-report",
+              "icon-pack"
+            ],
+            "type": "string"
+          },
+          "expectedWidth": {
+            "description": "Exact expected output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "marketplace": {
+            "description": "Marketplace profile name used for human-readable QA context.",
+            "enum": [
+              "shopify",
+              "amazon",
+              "google-merchant"
+            ],
+            "type": "string"
+          },
+          "maxHeight": {
+            "description": "Maximum allowed output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "maxOutputKB": {
+            "description": "Recommended maximum output size per non-archive file.",
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          "maxWidth": {
+            "description": "Maximum allowed output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minHeight": {
+            "description": "Minimum recommended output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minWidth": {
+            "description": "Minimum recommended output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "requireSquare": {
+            "description": "Require square output dimensions when true.",
+            "type": "boolean"
+          },
+          "visualChecks": {
+            "description": "Visual checks requested by a recipe. Current validator reports these as metadata-only limitations.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "id": {
+    "description": "Stable recipe id, for example shopify_product_pack.",
+    "minLength": 1,
+    "type": "string"
+  },
+  "requires": {
+    "additionalProperties": {},
+    "description": "Recipe requirements such as maxFiles and payment policy.",
+    "properties": {
+      "maxFiles": {
+        "description": "Maximum files allowed by this recipe.",
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "payment": {
+        "description": "Whether the recipe normally needs a paid batch/scenario unlock.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "title": {
+    "description": "Human-readable recipe title.",
+    "type": "string"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +[
+  "id",
+  "applySettings"
+]

Added value: +"QuokkaPix result manifest returned by getResultManifest() or saved as quokkapix-result.json."

Added value: +{
+  "errorCode": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Stable error code when the run failed or was cancelled."
+  },
+  "mode": {
+    "description": "Run mode reported by QuokkaPix.",
+    "enum": [
+      "single",
+      "batch"
+    ],
+    "type": "string"
+  },
+  "outputs": {
+    "description": "Detailed output entries.",
+    "items": {
+      "additionalProperties": {},
+      "description": "One output file or ZIP entry from quokkapix-result.json.",
+      "properties": {
+        "format": {
+          "description": "Output format such as webp, jpg, png, pdf or zip.",
+          "type": "string"
+        },
+        "outputHeight": {
+          "description": "Output image height in pixels.",
+          "type": "number"
+        },
+        "outputName": {
+          "description": "Output file or ZIP entry name.",
+          "type": "string"
+        },
+        "outputWidth": {
+          "description": "Output image width in pixels.",
+          "type": "number"
+        },
+        "sizeBytes": {
+          "description": "Output byte size when available.",
+          "type": "number"
+        },
+        "sourceHeight": {
+          "description": "Original image height in pixels.",
+          "type": "number"
+        },
+        "sourceName": {
+          "description": "Original input file name when available.",
+          "type": "string"
+        },
+        "sourceWidth": {
+          "description": "Original image width in pixels.",
+          "type": "number"
+        },
+        "warnings": {
+          "description": "Warnings for this output entry.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "processingMs": {
+    "description": "Processing time in milliseconds when available.",
+    "type": "number"
+  },
+  "source": {
+    "additionalProperties": {},
+    "description": "Source file summary.",
+    "properties": {
+      "count": {
+        "description": "Number of source files.",
+        "type": "number"
+      },
+      "totalBytes": {
+        "description": "Total input bytes when available.",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "status": {
+    "description": "Terminal status, expected to be done for a successful run.",
+    "type": "string"
+  },
+  "success": {
+    "description": "Whether QuokkaPix considered the run successful.",
+    "type": "boolean"
+  },
+  "tool": {
+    "description": "QuokkaPix tool/workflow that produced the output.",
+    "type": "string"
+  },
+  "warnings": {
+    "description": "Run-level warnings.",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +"Optional custom recipe with expectedResult.qa. Used instead of recipeId when provided."

Added value: +{
+  "applySettings": {
+    "additionalProperties": {},
+    "description": "QuokkaPix settings applied before processing starts.",
+    "properties": {
+      "mode": {
+        "description": "Use single for one image or batch for multiple images.",
+        "enum": [
+          "single",
+          "batch"
+        ],
+        "type": "string"
+      },
+      "steps": {
+        "description": "Optional ordered scenario steps. Prefer [{ tool, settings }] for custom multi-step workflows.",
+        "items": {
+          "anyOf": [
+            {
+              "description": "Simple QuokkaPix tool id step, for example resize, background, compress or watermark.",
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "description": "Structured scenario step with a tool id and per-step settings.",
+              "properties": {
+                "settings": {
+                  "additionalProperties": {},
+                  "description": "Settings for this step using the same keys accepted by window.QuokkaPixAgent.applySettings.",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                "tool": {
+                  "description": "QuokkaPix tool id for this scenario step, for example resize, background, compress or watermark.",
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "tool"
+              ],
+              "type": "object"
+            }
+          ],
+          "description": "One step in a QuokkaPix scenario workflow."
+        },
+        "type": "array"
+      },
+      "tool": {
+        "description": "QuokkaPix editor tool id, such as resize, crop, rotate, convert, compress, metadata, background, watermark, effects, rename, pdf, favicon or constructor.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "description": {
+    "description": "Short explanation of what the recipe prepares.",
+    "type": "string"
+  },
+  "expectedResult": {
+    "additionalProperties": {},
+    "description": "Expected output and QA contract.",
+    "properties": {
+      "output": {
+        "description": "Expected output type, for example zip, image, pdf or json.",
+        "type": "string"
+      },
+      "qa": {
+        "additionalProperties": {},
+        "description": "Machine-readable QA checks for the result manifest.",
+        "properties": {
+          "allowedFormats": {
+            "description": "Allowed output formats for every manifest output entry.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "expectedFormat": {
+            "description": "Required output format, for example webp, jpg, png, pdf or zip.",
+            "type": "string"
+          },
+          "expectedHeight": {
+            "description": "Exact expected output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "expectedMinOutputs": {
+            "description": "Minimum number of output entries expected.",
+            "maximum": 9007199254740991,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedOutputKind": {
+            "description": "Expected high-level output kind for QA checks.",
+            "enum": [
+              "single",
+              "batch",
+              "zip",
+              "pdf",
+              "metadata-report",
+              "icon-pack"
+            ],
+            "type": "string"
+          },
+          "expectedWidth": {
+            "description": "Exact expected output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "marketplace": {
+            "description": "Marketplace profile name used for human-readable QA context.",
+            "enum": [
+              "shopify",
+              "amazon",
+              "google-merchant"
+            ],
+            "type": "string"
+          },
+          "maxHeight": {
+            "description": "Maximum allowed output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "maxOutputKB": {
+            "description": "Recommended maximum output size per non-archive file.",
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          "maxWidth": {
+            "description": "Maximum allowed output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minHeight": {
+            "description": "Minimum recommended output height in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "minWidth": {
+            "description": "Minimum recommended output width in pixels.",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "requireSquare": {
+            "description": "Require square output dimensions when true.",
+            "type": "boolean"
+          },
+          "visualChecks": {
+            "description": "Visual checks requested by a recipe. Current validator reports these as metadata-only limitations.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "id": {
+    "description": "Stable recipe id, for example shopify_product_pack.",
+    "minLength": 1,
+    "type": "string"
+  },
+  "requires": {
+    "additionalProperties": {},
+    "description": "Recipe requirements such as maxFiles and payment policy.",
+    "properties": {
+      "maxFiles": {
+        "description": "Maximum files allowed by this recipe.",
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "payment": {
+        "description": "Whether the recipe normally needs a paid batch/scenario unlock.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "title": {
+    "description": "Human-readable recipe title.",
+    "type": "string"
+  }
+}

Removed value: -{
-  "type": "string"
-}

Added value: +[
+  "id",
+  "applySettings"
+]

Added value: +"Optional official recipe id whose expectedResult.qa contract should be used."

Added value: +"Optional QuokkaPix site base URL. Defaults to https://quokkapix.com."

Added value: +"False for preflight verification. True consumes the unlock and should be used only at run start."

Added value: +"Expected currency. Defaults to live payment options."

Added value: +"Number of files intended for the paid run."

Added value: +"Run mode to verify against the unlock token."

Added value: +[
+  "single",
+  "batch",
+  "scenario"
+]

Added value: +"Expected price string. Defaults to live payment options."

Added value: +"Expected QuokkaPix scope. Defaults to live payment options."

Added value: +"Unlock token returned by the paid x402 unlock endpoint."