Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "JSON result; identical to the text content block.",
+  "type": "object"
+}

Added value: +{
+  "description": "Optional task reference (rq_ + 12 hex) from an earlier answer. Continues that task: its remembered facts (quantities, budget, requirements, benchmark selection) apply to this call, and the answer keeps the same request_ref.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional (1.17.0): reuse the exact set of comparable providers selected by an earlier price_benchmark / market_report / research_capability call (its cohort_ref), instead of re-selecting the market from new wording.",
+  "type": "string"
+}

Added value: +{
+  "description": "Billing commitment of proposed_price (default monthly).",
+  "enum": [
+    "monthly",
+    "annual"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Currency of proposed_price (ISO code, default USD).",
+  "type": "string"
+}

Added value: +{
+  "description": "Observations per page in full mode (1–100, default 50).",
+  "type": "number"
+}

Added value: +{
+  "description": "Paging offset over the selected observations in full mode.",
+  "type": "number"
+}

Previous value: -"Optional pricing unit to hold constant (e.g. 'flat', 'per_seat', 'per_agent'). Incompatible units are never combined."New value: +"Billing unit the benchmark is FOR (1.17.0: honoured). Selects the comparable observations; units are never converted into one another, and a thin unit returns its observations and the gap — never a flat-monthly substitute. A query such as 'cost per support ticket' sets it when omitted."

Added value: +[
+  "flat",
+  "per_seat",
+  "per_agent",
+  "per_call",
+  "per_ticket",
+  "per_conversation",
+  "per_resolution",
+  "per_transaction",
+  "per_invoice",
+  "per_document",
+  "per_page",
+  "per_minute",
+  "per_message",
+  "per_email",
+  "per_credit",
+  "per_token",
+  "percent_of_spend"
+]

Added value: +{
+  "description": "Optional (sellers): a proposed price to position against the selected comparable offers (same unit; currency below). Returns where it sits in the observed range; a percentile only with ≥5 comparable providers. A market reference, not an optimal price.",
+  "type": "number"
+}

Previous value: -"'summary' (default): compact per-type/per-tier benchmark matrix. 'full': also returns the deprecated blended legacy block + AEPI index."New value: +"'summary' (default): the selected benchmark with its top observations. 'full': every included observation (paged), with plan, native price, unit, commitment, source and observed date."

Previous value: -[
-  "provider",
-  "mcp",
-  "api",
-  "all"
-]New value: +[
+  "agent",
+  "mcp",
+  "api",
+  "all"
+]

Added value: +{
+  "description": "The capability to benchmark, in natural language, e.g. 'AI code review' or 'supplier invoice reconciliation'. Preferred input.",
+  "type": "string"
+}

Added value: +{
+  "description": "Alias of `query` (same text).",
+  "type": "string"
+}

Previous value: -"Niche slug (or an approximate slug / natural-language name — it is resolved to the canonical niche), e.g. 'contract-review-automation'"New value: +"Legacy alias of `query`, kept for older clients — prefer `query`."

Previous value: -"Sector name, e.g. 'legal' (ignored if niche is given)"New value: +"Sector name, e.g. 'legal' (ignored if a query is given)"

Added value: +{
+  "description": "Buyer tier being priced. Set when the user describes who is buying (an individual, a professional, a team/SME, or an enterprise). An individual licence must never be represented by the SME or enterprise price.",
+  "enum": [
+    "individual",
+    "pro",
+    "team_sme",
+    "enterprise",
+    "all"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional pricing unit to hold constant (e.g. 'flat', 'per_seat', 'per_agent'). Incompatible units are never combined.",
+  "type": "string"
+}

Added value: +{
+  "description": "Delivery type being priced. Set when the user says provider, MCP or API. Omit (or 'all') to get the per-type matrix instead of a blended figure. 'api' is recognised but not yet a separate commercial cohort (folded into provider).",
+  "enum": [
+    "provider",
+    "mcp",
+    "api",
+    "all"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "'summary' (default): compact per-type/per-tier benchmark matrix. 'full': also returns the deprecated blended legacy block + AEPI index.",
+  "enum": [
+    "summary",
+    "full"
+  ],
+  "type": "string"
+}

Previous value: -"Niche slug as returned by market_gaps/compare_agents, e.g. 'contract-review-automation'"New value: +"Niche slug (or an approximate slug / natural-language name — it is resolved to the canonical niche), e.g. 'contract-review-automation'"