Previous value: -"Cutoff used with concept, YYYY-MM-DD: the latest value filed on or before this date, e.g. 2024-06-30."New value: +"Cutoff used with concept, YYYY-MM-DD: the latest value filed on or before this date; a filing date, not a period end, e.g. 2024-06-30."

Removed value: -{
-  "description": "Older name for as_of_date, same format and meaning: a filing cutoff, not a period end, e.g. 2024-06-30.",
-  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-  "type": "string"
-}

Previous value: -"Point-in-time cutoff (YYYY-MM-DD) used with `concept` — returns the latest fact whose 10-K/10-Q was accepted by SEC on or before this date (true PIT, no lookahead; any calendar date works). Canonical name across the suite; supersedes the legacy `period_end`."New value: +"Cutoff used with concept, YYYY-MM-DD: the latest value filed on or before this date, e.g. 2024-06-30."

Previous value: -"Standard concept to look up the most recently known fact for (see the enum for the full fundamentals + capital-allocation set). Use this when you don't have a fact_id. Provide either concept OR fact_id."New value: +"Standard concept whose latest reported value to trace, used when no fact_id is given, e.g. TotalRevenue."

Previous value: -"Deterministic fact identity hash: SHA-256(entity_id|accession_id|concept|period_end|unit). 64-char lowercase hex. Use this when you already have the hash from a previous query. Provide either fact_id OR concept (not both required, but at least one must be set)."New value: +"64-character lowercase hex fact_id from an earlier result; give this or concept, e.g. 8a02707ced0d5a157ed2cdb28df035e52250daf4d0699952f7fc5420e1ce3afa."

Previous value: -"[DEPRECATED — pass `as_of_date` instead.] Filing-acceptance cutoff (YYYY-MM-DD) used with `concept`; despite the name it filters on filing accepted_at, not the returned fact's period_end. Kept one release for back-compat."New value: +"Older name for as_of_date, same format and meaning: a filing cutoff, not a period end, e.g. 2024-06-30."

Previous value: -"Stock ticker symbol, e.g. AAPL, MSFT, BRK.B — or a CIK (SEC identifier), e.g. '0000320193'."New value: +"Ticker symbol or SEC CIK of the company, e.g. AAPL."

Removed value: -{
-  "additionalProperties": false,
-  "description": "Per-call cost transparency. Omitted for subscription-only tools that have no PAYG-equivalent price.",
-  "properties": {
-    "amount_usd": {
-      "minimum": 0,
-      "type": "number"
-    },
-    "basis": {
-      "description": "payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed.",
-      "enum": [
-        "payg_charge",
-        "payg_rate_card"
-      ],
-      "type": "string"
-    },
-    "billed": {
-      "description": "true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free.",
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "amount_usd",
-    "billed",
-    "basis"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Access plan: sample | sp500 | pro | full",
-  "type": "string"
-}

Previous value: -"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt in bulk. Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."New value: +"Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."

Removed value: -{
-  "description": "ISO timestamp when the snapshot was exported",
-  "type": "string"
-}

Removed value: -{
-  "description": "Wall-clock milliseconds this tool call took, measured server-side around the handler.",
-  "minimum": 0,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Soft-warning array for partial fulfillment. Each entry carries a stable subcode + remediation.options[]. AI agents pattern-match on subcode.",
-  "items": {
-    "additionalProperties": true,
-    "properties": {
-      "code": {
-        "const": "LIMIT_EXCEEDED",
-        "type": "string"
-      },
-      "current_plan": {
-        "type": "string"
-      },
-      "extensions": {
-        "additionalProperties": {},
-        "type": "object"
-      },
-      "limit_type": {
-        "type": "string"
-      },
-      "limit_value": {},
-      "remediation": {
-        "additionalProperties": true,
-        "properties": {
-          "contact_sales": {
-            "type": "string"
-          },
-          "default_action": {
-            "type": "string"
-          },
-          "options": {
-            "items": {
-              "additionalProperties": {},
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "pricing_page": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "options",
-          "default_action",
-          "pricing_page",
-          "contact_sales"
-        ],
-        "type": "object"
-      },
-      "requested_value": {},
-      "returned_value": {},
-      "subcode": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "code",
-      "subcode",
-      "limit_type",
-      "current_plan",
-      "remediation"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "Set when this single response was paid for via the agent-pay PAYG flow — the rate-limit / depth-limit checks were bypassed for this call only.",
-  "properties": {
-    "amount_cents": {
-      "type": "number"
-    },
-    "entity_scope_hash": {
-      "type": "string"
-    },
-    "meter": {
-      "type": "string"
-    },
-    "quote_id": {
-      "type": "string"
-    },
-    "retry_token_hash": {
-      "type": "string"
-    },
-    "ticker_count": {
-      "type": "number"
-    },
-    "tool": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "quote_id",
-    "tool",
-    "meter",
-    "amount_cents",
-    "ticker_count",
-    "entity_scope_hash",
-    "retry_token_hash"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "Caller's remaining budget",
-  "properties": {
-    "limit": {
-      "type": "integer"
-    },
-    "remaining": {
-      "type": "integer"
-    },
-    "reset_at": {
-      "description": "ISO 8601 timestamp when the window resets",
-      "type": "string"
-    },
-    "window": {
-      "enum": [
-        "minute",
-        "hour"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "limit",
-    "remaining",
-    "reset_at",
-    "window"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Per-request correlation id (8-char)",
-  "type": "string"
-}

Removed value: -{
-  "description": "Parquet schema version from manifest.json",
-  "type": "string"
-}

Removed value: -{
-  "description": "Snapshot directory name (e.g. snapshot_20260420)",
-  "type": "string"
-}

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

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

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

Previous value: -[
-  "data_plan",
-  "schema_version",
-  "snapshot",
-  "last_updated",
-  "source",
-  "pit_safe"
-]New value: +[
+  "source",
+  "pit_safe"
+]

Previous value: -"Full provenance for one fact. Identity: fact_id, entity_id, ticker, company_name, concept, standard_concept, accession_id. Value: numeric_value (raw), `display` (the SAME number already rendered — \"$391.04B\" — QUOTE THIS rather than re-rounding numeric_value yourself), unit, plus derived_quarterly_value/derived_quarterly_display (a Q2/Q3 10-Q states year-to-date, so the quarter and the filing are different numbers). Filing: source_url, inline_viewer_url, document_url, filing_date, form_type, accepted_at. Duration: period_start, period_end, period_span_days, and period_type (instant | quarterly | half_year | nine_month | annual | duration) so a 3-month stub is never mistaken for the 12-month figure — a 10-K tags BOTH at the same period_end. ⚠️ There is no `value` key and no `cik` key; the fields are named exactly as emitted."New value: +"Full provenance for one fact. Identity: fact_id, entity_id, ticker, company_name, concept, standard_concept, accession_id. Filing: source_url, inline_viewer_url, document_url, filing_date, form_type, accepted_at. Duration: period_start, period_end, period_span_days, and period_type (instant | quarterly | half_year | nine_month | annual | duration) so a 3-month stub is never mistaken for the 12-month figure — a 10-K tags BOTH at the same period_end."

Previous value: -"`numeric_value` ALREADY RENDERED — \"$391.04B\", \"$6.11\". QUOTE THIS character-for-character rather than re-rounding `numeric_value` yourself: the rendering also needs a scale, and `unit` alone cannot tell a fraction (0.5965 → \"59.65%\") from a percent (0.5965 → \"0.60%\"). Null when `numeric_value` is null."New value: +"Null when `numeric_value` is null."

Removed value: -"Valuein's standardized concept name (TotalRevenue, NetIncome, …); null when the raw tag is unmapped."

Previous value: -"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt. Use THIS — not `last_updated` — when telling a user how current the fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to."New value: +"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt in bulk. Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."

Previous value: -trueNew value: +false

Previous value: -"Full provenance: fact_id, concept, value, unit, period_end, source accession, SEC EDGAR URL, form_type, accepted_at, plus duration context — period_start, period_span_days, and period_type (instant | quarterly | half_year | nine_month | annual | duration) so a 3-month stub is never mistaken for the 12-month figure."New value: +"Full provenance for one fact. Identity: fact_id, entity_id, ticker, company_name, concept, standard_concept, accession_id. Value: numeric_value (raw), `display` (the SAME number already rendered — \"$391.04B\" — QUOTE THIS rather than re-rounding numeric_value yourself), unit, plus derived_quarterly_value/derived_quarterly_display (a Q2/Q3 10-Q states year-to-date, so the quarter and the filing are different numbers). Filing: source_url, inline_viewer_url, document_url, filing_date, form_type, accepted_at. Duration: period_start, period_end, period_span_days, and period_type (instant | quarterly | half_year | nine_month | annual | duration) so a 3-month stub is never mistaken for the 12-month figure — a 10-K tags BOTH at the same period_end. ⚠️ There is no `value` key and no `cik` key; the fields are named exactly as emitted."

Added value: +{
+  "description": "SEC acceptance timestamp (ISO 8601) — the moment this number became public. The PIT cut is taken on this.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "SEC accession number of the filing that reported this value, e.g. 0000320193-24-000123.",
+  "type": "string"
+}

Added value: +{
+  "description": "Registrant name as filed.",
+  "type": "string"
+}

Added value: +{
+  "description": "Raw XBRL tag as the filer used it, e.g. us-gaap:Revenues.",
+  "type": "string"
+}

Added value: +{
+  "description": "`derived_quarterly_value` rendered the same way. Null when that value is null.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The three-month figure derived from a year-to-date filing. A Q2/Q3 10-Q states YTD, so THIS and `numeric_value` are different numbers for the same fact — a verifier comparing against whichever one it happened to read passes wrong numbers half the time. Null when no derivation applies.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "`numeric_value` ALREADY RENDERED — \"$391.04B\", \"$6.11\". QUOTE THIS character-for-character rather than re-rounding `numeric_value` yourself: the rendering also needs a scale, and `unit` alone cannot tell a fraction (0.5965 → \"59.65%\") from a percent (0.5965 → \"0.60%\"). Null when `numeric_value` is null.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Direct link to the rendered primary document (not the index page). Null when the primary document is unknown.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Zero-padded 10-digit SEC CIK of the filer. (The key is named entity_id — there is no `cik` field.)",
+  "type": "string"
+}

Added value: +{
+  "description": "Deterministic fact identity: SHA-256(entity_id|accession_id|concept|period_end|unit), 64-char lowercase hex.",
+  "type": "string"
+}

Added value: +{
+  "description": "Filing date (YYYY-MM-DD). Null when the filing join found nothing.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Filing form type — 10-K, 10-Q, 8-K, 20-F. Null when the filing join found nothing.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "SEC Inline-XBRL viewer opened on the rendered primary document — the strongest one-click verification link. Null when the filing is not Inline-XBRL or the primary document is unknown.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The raw reported value. Null when the fact carries no numeric value.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "End of the reporting window (YYYY-MM-DD), or the instant date for balance-sheet facts.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Length of the reporting window in days. Null when not derivable.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Start of the reporting window (YYYY-MM-DD). Null for instant (balance-sheet) facts.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Coarse duration class: instant | quarterly | half_year | nine_month | annual | duration. A single 10-K tags BOTH a 12-month figure and a 3-month Q4 stub at the same period_end, so this is what stops a stub being quoted as the annual number.",
+  "type": "string"
+}

Added value: +{
+  "description": "SEC filing-index URL. Null when the filing join found nothing.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Valuein's standardized concept name (TotalRevenue, NetIncome, …); null when the raw tag is unmapped.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Uppercase ticker the lookup resolved through.",
+  "type": "string"
+}

Added value: +{
+  "description": "Unit of the value, e.g. USD, USD/share, shares.",
+  "type": "string"
+}

Added value: +[
+  "fact_id",
+  "entity_id",
+  "ticker",
+  "company_name",
+  "accession_id",
+  "concept",
+  "standard_concept",
+  "unit",
+  "numeric_value",
+  "derived_quarterly_value",
+  "display",
+  "derived_quarterly_display",
+  "accepted_at",
+  "source_url",
+  "inline_viewer_url",
+  "document_url",
+  "filing_date",
+  "form_type",
+  "period_start",
+  "period_end",
+  "period_span_days",
+  "period_type"
+]

Previous value: -"Stock ticker symbol, e.g. AAPL, MSFT, BRK.B"New value: +"Stock ticker symbol, e.g. AAPL, MSFT, BRK.B — or a CIK (SEC identifier), e.g. '0000320193'."

Previous value: -"^[A-Za-z.\\-]+$"New value: +"^[A-Za-z0-9.\\-]+$"

Added value: +{
+  "description": "ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt. Use THIS — not `last_updated` — when telling a user how current the fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to.",
+  "type": "string"
+}

Added value: +{
+  "description": "ISO timestamp when the price surfaces were last refreshed.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Per-call cost transparency. Omitted for subscription-only tools that have no PAYG-equivalent price.",
+  "properties": {
+    "amount_usd": {
+      "minimum": 0,
+      "type": "number"
+    },
+    "basis": {
+      "description": "payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed.",
+      "enum": [
+        "payg_charge",
+        "payg_rate_card"
+      ],
+      "type": "string"
+    },
+    "billed": {
+      "description": "true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "amount_usd",
+    "billed",
+    "basis"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Wall-clock milliseconds this tool call took, measured server-side around the handler.",
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"Point-in-time cutoff (YYYY-MM-DD) used with `concept`. Returns the most recently known fact whose 10-K / 10-Q filing was accepted by SEC on or before this date — true PIT, no lookahead bias.  Any calendar date works (not limited to fiscal-period closes); the latest preceding filing is returned.  This is the canonical name shared by every other PIT tool in the suite; supersedes the legacy `period_end` parameter on this tool."New value: +"Point-in-time cutoff (YYYY-MM-DD) used with `concept` — returns the latest fact whose 10-K/10-Q was accepted by SEC on or before this date (true PIT, no lookahead; any calendar date works). Canonical name across the suite; supersedes the legacy `period_end`."

Previous value: -"Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Covers the full fundamentals + capital-allocation set: income statement (TotalRevenue, CostOfRevenue, GrossProfit, OperatingIncome, OperatingExpenses, ResearchAndDevelopment, NetIncome, EPSDiluted), balance sheet (TotalAssets, TotalLiabilities, StockholdersEquity, StockholdersEquityIncludingNCI, CashAndEquivalents, TotalDebt), and cash flow (OperatingCashFlow, CAPEX, Dividends, ShareBuyback, DebtIssuance, DebtRepayment, Acquisitions, Divestitures). Provide either concept OR fact_id."New value: +"Standard concept to look up the most recently known fact for (see the enum for the full fundamentals + capital-allocation set). Use this when you don't have a fact_id. Provide either concept OR fact_id."

Previous value: -"[DEPRECATED — pass `as_of_date` instead.] Filing-acceptance cutoff (YYYY-MM-DD) used with `concept`. The name is misleading — it actually filters on filing accepted_at, not on the period_end of the returned fact (the returned fact's period_end is whatever the SEC filed, e.g. a Q3 cumulative figure). Kept for one release for backwards compat; new callers MUST use `as_of_date`."New value: +"[DEPRECATED — pass `as_of_date` instead.] Filing-acceptance cutoff (YYYY-MM-DD) used with `concept`; despite the name it filters on filing accepted_at, not the returned fact's period_end. Kept one release for back-compat."

Added value: +"true iff a zero-look-ahead point-in-time cut was applied to every returned figure"

Previous value: -"Full provenance: fact_id, concept, value, source accession, SEC EDGAR URL, form_type, first_filed_at, latest_accepted_at, restated flag"New value: +"Full provenance: fact_id, concept, value, unit, period_end, source accession, SEC EDGAR URL, form_type, accepted_at, plus duration context — period_start, period_span_days, and period_type (instant | quarterly | half_year | nine_month | annual | duration) so a 3-month stub is never mistaken for the 12-month figure."

Previous value: -"Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Allowed: TotalRevenue, NetIncome, EPSDiluted, TotalAssets, TotalLiabilities, OperatingCashFlow, CAPEX. Provide either concept OR fact_id."New value: +"Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Covers the full fundamentals + capital-allocation set: income statement (TotalRevenue, CostOfRevenue, GrossProfit, OperatingIncome, OperatingExpenses, ResearchAndDevelopment, NetIncome, EPSDiluted), balance sheet (TotalAssets, TotalLiabilities, StockholdersEquity, StockholdersEquityIncludingNCI, CashAndEquivalents, TotalDebt), and cash flow (OperatingCashFlow, CAPEX, Dividends, ShareBuyback, DebtIssuance, DebtRepayment, Acquisitions, Divestitures). Provide either concept OR fact_id."

Previous value: -[
-  "TotalRevenue",
-  "NetIncome",
-  "EPSDiluted",
-  "TotalAssets",
-  "TotalLiabilities",
-  "OperatingCashFlow",
-  "CAPEX"
-]New value: +[
+  "TotalRevenue",
+  "CostOfRevenue",
+  "GrossProfit",
+  "OperatingIncome",
+  "OperatingExpenses",
+  "ResearchAndDevelopment",
+  "NetIncome",
+  "EPSDiluted",
+  "TotalAssets",
+  "TotalLiabilities",
+  "StockholdersEquity",
+  "StockholdersEquityIncludingNCI",
+  "CashAndEquivalents",
+  "TotalDebt",
+  "OperatingCashFlow",
+  "CAPEX",
+  "Dividends",
+  "ShareBuyback",
+  "DebtIssuance",
+  "DebtRepayment",
+  "Acquisitions",
+  "Divestitures"
+]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "_meta": {
+      "additionalProperties": false,
+      "description": "Provenance envelope — data lineage for every MCP response",
+      "properties": {
+        "as_of_date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "data_plan": {
+          "description": "Access plan: sample | sp500 | pro | full",
+          "type": "string"
+        },
+        "data_quality": {
+          "additionalProperties": false,
+          "description": "Server-side invariants run on this response",
+          "properties": {
+            "notes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "validation_failed": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "detail": {
+                    "type": "string"
+                  },
+                  "rule": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "rule",
+                  "detail"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "validation_passed": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "validation_passed",
+            "validation_failed",
+            "notes"
+          ],
+          "type": "object"
+        },
+        "last_updated": {
+          "description": "ISO timestamp when the snapshot was exported",
+          "type": "string"
+        },
+        "limit_warnings": {
+          "description": "Soft-warning array for partial fulfillment. Each entry carries a stable subcode + remediation.options[]. AI agents pattern-match on subcode.",
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "code": {
+                "const": "LIMIT_EXCEEDED",
+                "type": "string"
+              },
+              "current_plan": {
+                "type": "string"
+              },
+              "extensions": {
+                "additionalProperties": {},
+                "type": "object"
+              },
+              "limit_type": {
+                "type": "string"
+              },
+              "limit_value": {},
+              "remediation": {
+                "additionalProperties": true,
+                "properties": {
+                  "contact_sales": {
+                    "type": "string"
+                  },
+                  "default_action": {
+                    "type": "string"
+                  },
+                  "options": {
+                    "items": {
+                      "additionalProperties": {},
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "pricing_page": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "options",
+                  "default_action",
+                  "pricing_page",
+                  "contact_sales"
+                ],
+                "type": "object"
+              },
+              "requested_value": {},
+              "returned_value": {},
+              "subcode": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "code",
+              "subcode",
+              "limit_type",
+              "current_plan",
+              "remediation"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "payg_override": {
+          "additionalProperties": false,
+          "description": "Set when this single response was paid for via the agent-pay PAYG flow — the rate-limit / depth-limit checks were bypassed for this call only.",
+          "properties": {
+            "amount_cents": {
+              "type": "number"
+            },
+            "entity_scope_hash": {
+              "type": "string"
+            },
+            "meter": {
+              "type": "string"
+            },
+            "quote_id": {
+              "type": "string"
+            },
+            "retry_token_hash": {
+              "type": "string"
+            },
+            "ticker_count": {
+              "type": "number"
+            },
+            "tool": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "quote_id",
+            "tool",
+            "meter",
+            "amount_cents",
+            "ticker_count",
+            "entity_scope_hash",
+            "retry_token_hash"
+          ],
+          "type": "object"
+        },
+        "pit_safe": {
+          "type": "boolean"
+        },
+        "rate_limit": {
+          "additionalProperties": false,
+          "description": "Caller's remaining budget",
+          "properties": {
+            "limit": {
+              "type": "integer"
+            },
+            "remaining": {
+              "type": "integer"
+            },
+            "reset_at": {
+              "description": "ISO 8601 timestamp when the window resets",
+              "type": "string"
+            },
+            "window": {
+              "enum": [
+                "minute",
+                "hour"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "limit",
+            "remaining",
+            "reset_at",
+            "window"
+          ],
+          "type": "object"
+        },
+        "request_id": {
+          "description": "Per-request correlation id (8-char)",
+          "type": "string"
+        },
+        "result_count": {
+          "type": "integer"
+        },
+        "schema_version": {
+          "description": "Parquet schema version from manifest.json",
+          "type": "string"
+        },
+        "snapshot": {
+          "description": "Snapshot directory name (e.g. snapshot_20260420)",
+          "type": "string"
+        },
+        "source": {
+          "const": "SEC EDGAR",
+          "type": "string"
+        },
+        "ticker": {
+          "type": "string"
+        },
+        "truncation": {
+          "additionalProperties": false,
+          "description": "Set when fewer rows were returned than requested — explains why and points to a remedy",
+          "properties": {
+            "current_plan": {
+              "type": "string"
+            },
+            "plan_limit": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "reason": {
+              "enum": [
+                "PLAN_LIMIT",
+                "DATA_NOT_AVAILABLE",
+                "FISCAL_YEAR_BOUNDARY_FILTER",
+                "OTHER"
+              ],
+              "type": "string"
+            },
+            "requested": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "returned": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "upgrade_required_for": {
+              "type": "string"
+            },
+            "upgrade_url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "requested",
+            "returned",
+            "reason"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "data_plan",
+        "schema_version",
+        "snapshot",
+        "last_updated",
+        "source",
+        "pit_safe"
+      ],
+      "type": "object"
+    },
+    "lineage": {
+      "additionalProperties": true,
+      "description": "Full provenance: fact_id, concept, value, source accession, SEC EDGAR URL, form_type, first_filed_at, latest_accepted_at, restated flag",
+      "properties": {},
+      "type": "object"
+    },
+    "lookup_by": {
+      "description": "How the fact was located: 'fact_id' or 'concept'",
+      "type": "string"
+    },
+    "verified": {
+      "description": "True when the fact was located and its provenance resolved",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "_meta",
+    "verified",
+    "lookup_by"
+  ],
+  "type": "object"
+}

Previous value: -"Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Allowed: TotalRevenue, NetIncome, EPS_Diluted, TotalAssets, TotalLiabilities, OperatingCashFlow, CAPEX. Provide either concept OR fact_id."New value: +"Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Allowed: TotalRevenue, NetIncome, EPSDiluted, TotalAssets, TotalLiabilities, OperatingCashFlow, CAPEX. Provide either concept OR fact_id."

Previous value: -[
-  "TotalRevenue",
-  "NetIncome",
-  "EPS_Diluted",
-  "TotalAssets",
-  "TotalLiabilities",
-  "OperatingCashFlow",
-  "CAPEX"
-]New value: +[
+  "TotalRevenue",
+  "NetIncome",
+  "EPSDiluted",
+  "TotalAssets",
+  "TotalLiabilities",
+  "OperatingCashFlow",
+  "CAPEX"
+]

Added value: +{
+  "description": "Point-in-time cutoff (YYYY-MM-DD) used with `concept`. Returns the most recently known fact whose 10-K / 10-Q filing was accepted by SEC on or before this date — true PIT, no lookahead bias.  Any calendar date works (not limited to fiscal-period closes); the latest preceding filing is returned.  This is the canonical name shared by every other PIT tool in the suite; supersedes the legacy `period_end` parameter on this tool.",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

Previous value: -"Optional point-in-time cutoff (YYYY-MM-DD) used with `concept`. Returns the most recently known fact whose 10-K / 10-Q filing was accepted by SEC on or before this date — true PIT, no lookahead bias. Any calendar date works (not limited to fiscal-period closes); the latest preceding filing is returned. Ignored when `fact_id` is supplied."New value: +"[DEPRECATED — pass `as_of_date` instead.] Filing-acceptance cutoff (YYYY-MM-DD) used with `concept`. The name is misleading — it actually filters on filing accepted_at, not on the period_end of the returned fact (the returned fact's period_end is whatever the SEC filed, e.g. a Q3 cumulative figure). Kept for one release for backwards compat; new callers MUST use `as_of_date`."

Added value: +"http://json-schema.org/draft-07/schema#"

Added value: +false

Added value: +{
+  "description": "Standard concept name to look up the most recently known fact for. Use this when you don't have a fact_id. Allowed: TotalRevenue, NetIncome, EPS_Diluted, TotalAssets, TotalLiabilities, OperatingCashFlow, CAPEX. Provide either concept OR fact_id.",
+  "enum": [
+    "TotalRevenue",
+    "NetIncome",
+    "EPS_Diluted",
+    "TotalAssets",
+    "TotalLiabilities",
+    "OperatingCashFlow",
+    "CAPEX"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Deterministic fact identity hash: SHA-256(entity_id|accession_id|concept|period_end|unit). 64-char lowercase hex. Use this when you already have the hash from a previous query. Provide either fact_id OR concept (not both required, but at least one must be set).",
+  "pattern": "^[0-9a-f]{64}$",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional point-in-time cutoff (YYYY-MM-DD) used with `concept`. Returns the most recently known fact whose 10-K / 10-Q filing was accepted by SEC on or before this date — true PIT, no lookahead bias. Any calendar date works (not limited to fiscal-period closes); the latest preceding filing is returned. Ignored when `fact_id` is supplied.",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

Added value: +{
+  "description": "Stock ticker symbol, e.g. AAPL, MSFT, BRK.B",
+  "maxLength": 10,
+  "minLength": 1,
+  "pattern": "^[A-Za-z.\\-]+$",
+  "type": "string"
+}

Added value: +[
+  "ticker"
+]

Removed value: -"http://json-schema.org/draft-07/schema#"

Removed value: -false

Removed value: -{
-  "description": "The deterministic fact identity hash: SHA-256(entity_id|accession_id|concept|period_end|unit). 64-character lowercase hex string.",
-  "pattern": "^[0-9a-f]{64}$",
-  "type": "string"
-}

Removed value: -{
-  "description": "Stock ticker symbol, e.g. AAPL, MSFT, BRK.B",
-  "maxLength": 10,
-  "minLength": 1,
-  "pattern": "^[A-Za-z.\\-]+$",
-  "type": "string"
-}

Removed value: -[
-  "ticker",
-  "fact_id"
-]