Added value: +{
+  "description": "Pass true when editing a private draft: the call is refused with `not_a_draft` (nothing written) unless the report is private, never published and not signed off. Lets a client run the edit without asking, because a draft edit is undoable and reaches no reader.",
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "args": {
+          "additionalProperties": false,
+          "properties": {
+            "change_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "change_id"
+          ],
+          "type": "object"
+        },
+        "tool": {
+          "const": "undo_change",
+          "type": "string"
+        }
+      },
+      "required": [
+        "tool",
+        "args"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "How to put the record back as it was before this write: call `undo_change` with these args. Null when nothing changed or the change could not be recorded."
+}

Previous value: -[
-  "_meta",
-  "report",
-  "version",
-  "previous_version",
-  "archived"
-]New value: +[
+  "_meta",
+  "report",
+  "version",
+  "previous_version",
+  "archived",
+  "undo"
+]

Added value: +{
+  "description": "The filed numbers, as the source writes them, that a computed figure was derived from (0-4).",
+  "items": {
+    "maxLength": 60,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 4,
+  "type": "array"
+}

Added value: +{
+  "description": "Filing section key exactly as list_filing_sections returns it ('7', 'I-2', 'note-5', '4.02', 'ex-99.1'). Required when source is 'text'.",
+  "maxLength": 40,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Where the figure was read: 'fact' (a Valuein fact_id/derived_id), 'text' (quoted from filing text; needs `section`), 'insider' (a Form 3/4/5 row) or 'holdings' (a 13F row, or an issuer aggregate named by `period_end`). `accession_ids[0]` names the filing for text/insider/holdings.",
+  "enum": [
+    "fact",
+    "text",
+    "insider",
+    "holdings"
+  ],
+  "type": "string"
+}

Previous value: -"payg_charge = real charge (agent-pay or your balance). payg_rate_card = indicative price, not billed."New value: +"payg_charge = real pay-per-call charge (a card or MPP payment through agent-pay). payg_rate_card = indicative price, not billed."

Previous value: -"payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed."New value: +"payg_charge = real charge (agent-pay or your balance). payg_rate_card = indicative price, not billed."

Previous value: -"true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free."New value: +"true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value only: no charge was made for this call (it was within your plan)."

Previous value: -"Valuein fact_ids backing the claim, as returned by the data tools."New value: +"Valuein fact_ids (or `drv1:` derived ids) backing the claim, exactly as the data tools returned them."

Previous value: -128New value: +1024

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."

Added value: +{
+  "description": "Lineage for figures in the edited sections. MERGED into the report's existing citations (first claim wins), never replacing them — so an editor autosave that sends none preserves every citation the report already had.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "accession_ids": {
+        "description": "Optional SEC accession ids backing the claim.",
+        "items": {
+          "maxLength": 32,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "claim": {
+        "description": "Plain-English claim, quoting the figure as the prose writes it (e.g. 'FY2024 revenue: $391.0B').",
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "evidence": {
+        "description": "Provenance class. Defaults to 'derived' — the weaker claim.",
+        "enum": [
+          "primary",
+          "derived",
+          "external"
+        ],
+        "type": "string"
+      },
+      "fact_ids": {
+        "description": "Valuein fact_ids backing the claim, as returned by the data tools.",
+        "items": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "filed_at": {
+        "description": "SEC acceptance timestamp of the filing (ISO 8601) — when the figure became public.",
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      },
+      "form_type": {
+        "description": "SEC form the figure was reported on ('10-K', '10-Q', '20-F'), verbatim from the source.",
+        "maxLength": 20,
+        "minLength": 1,
+        "type": "string"
+      },
+      "period_end": {
+        "description": "Last day of the period the figure COVERS (YYYY-MM-DD). Not the filing date.",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "type": "string"
+      },
+      "period_label": {
+        "description": "How the filer names that period: 'FY2025', 'Q3 2025'.",
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      },
+      "sec_urls": {
+        "description": "Optional EDGAR URLs, one per accession.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "ticker": {
+        "description": "Ticker the fact belongs to. Lets a figure be verified when the report has no ticker.",
+        "maxLength": 10,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "claim",
+      "fact_ids"
+    ],
+    "type": "object"
+  },
+  "maxItems": 1000,
+  "type": "array"
+}

Added value: +{
+  "description": "Section ids to DELETE outright. Without this, a merge-only update cannot express a deletion: an editor that drops a section simply omits it, the omitted section is preserved, and the caller sees a bumped version with the deleted content still there — a save that reports success and changed nothing. Ids must exist, and the last remaining section cannot be removed (a report with no sections is unreadable); remove the report instead with delete_report.",
+  "items": {
+    "maxLength": 128,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 20,
+  "type": "array"
+}

Previous value: -"Sections to replace. Sections not listed are preserved. Section ids must match the existing payload."New value: +"Sections to replace. Sections not listed are preserved — to DELETE one, name it in `remove_section_ids`. Section ids must match the existing payload."

Removed value: -1

Removed value: -1

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

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

Previous value: -[
-  "_meta",
-  "report",
-  "vectorize_reindexed",
-  "version",
-  "previous_version",
-  "archived"
-]New value: +[
+  "_meta",
+  "report",
+  "version",
+  "previous_version",
+  "archived"
+]

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

Added value: +"Identifier of the report to update, as returned by create_report or list_my_reports."

Added value: +{
+  "description": "Optimistic concurrency check. If supplied and the current HEAD version is different, the call returns a `version_conflict` error WITHOUT writing. Pass the version you loaded so a concurrent agent edit produces a 'conflict — review' UX instead of silently overwriting (eng review A3A).",
+  "exclusiveMinimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Previous value: -[
-  "_meta",
-  "report",
-  "vectorize_reindexed",
-  "version"
-]New value: +[
+  "_meta",
+  "report",
+  "vectorize_reindexed",
+  "version",
+  "previous_version",
+  "archived"
+]