Costory: Your Finops MCP

update_report

Destructive

Apply declarative partial changes to one non-archived report. Use when the user asks to change an existing report's content, schedule, or destinations. The get_skill reports guide explains DIGEST content, schedules, destinations, and reportContext. Omitted fields are preserved. Pass reportContext as a partial patch to edit the report-wide period, groupBy, metricId, currency, scopeId, or conditionsCel without recreating widgets — omit fields you want to keep; empty conditionsCel clears the filter. tagIds replaces the full list: existing IDs from list_tags and/or { name, color? } for new tags; color defaults to #6366F1; missing tags are created. Omit keeps stored tags; [] clears them. DANGER ZONE when changing schedule, widget, destinations, resuming to ACTIVE, or using schedule.mode NOW: summarize the merged future configuration and ask the user to confirm before calling. Pure pause plus metadata / reportContext edits can apply immediately. schedule.mode NOW converts to on-demand ACTIVE and sends immediately. Archived restore is forbidden in MCP. destinations replaces the full list (must be non-empty; omit to leave it unchanged). Mergeable same-type destinations share one execution after save (exclusive sentinels stay separate), as in create_report. widgets (an array) replaces the report's entire widget list wholesale, with type inside each widget; omit widgets to leave the widgets unchanged. The input field is always widgets (array) — a singular widget key is silently ignored. EXAMPLE pause: { reportId: "clx…", state: "PAUSED" } EXAMPLE context patch: { reportId: "clx…", reportContext: { datePreset: "LAST_WEEK", groupBy: "cos_service_name" } }

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "reportId": "<reportId>",
      "context": "<context>"
    },
    "name": "update_report"
  }
}

Input Schema

Name	Required	Description
`name`	No	Optional name patch.
`slug`	No	Organization slug. Omit to auto-detect from your account (fails if you belong to multiple orgs).
`scout`	No	Scout persona NAME (from list_scouts) or its id. Null clears the assignment; omitted leaves it unchanged.
`state`	No	ACTIVE or PAUSED (MCP-facing status).
`tagIds`	No	Replaces the full tag list. Omit to keep stored tags; pass [] to clear. Pass existing tag IDs from `list_tags`, and/or new tag objects `{ name, color? }` (created in the org if missing; color defaults to #6366F1).
`context`	Yes	A few words on why you are calling this tool, for the server developer's analytics. Describe people and things by role, such as "a customer". Do not quote the user or include names, emails, or other personal details.
`widgets`	No	When set, replaces the widget list wholesale; omit to leave unchanged. Same widget objects as `create_report` `widgets[]`.
`reportId`	Yes	Report id to patch.
`schedule`	No	Optional schedule replace. NOW / UNSCHEDULED / SCHEDULED (WEEKLY requires `weekday`).
`llm_model`	No	The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Pass "unknown" if you are not certain. Recorded for the server developer's analytics.
`description`	No	Optional description patch.
`destinations`	No	When set, replaces the destination list wholesale; omit to leave unchanged (never empties it). Same destination objects as `create_report` `destinations`.
`reportContext`	No	Partial patch for report-level shared context (same fields as `create_report` `reportContext`). Omitted fields keep their current values. Empty conditionsCel clears the filter. Can be used alone or together with `widgets`.
`conversation_id`	No	The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 14, 2026

changedInput schema / definitions / ReportMcpContext / properties / datePreset / description

Previous value: -"Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."New value: +"Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Use this when a preset matches the requested range; otherwise use startDate/endDate."

changedInput schema / definitions / ReportMcpQueries / description

Previous value: -"Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost inherits metricId/currency/groupBy from reportContext; usage requires metricId (omit groupBy = ungrouped). Budget groupBy is explicit (budget VD bqName); it does not inherit reportContext.groupBy. Cost/usage inherit conditionsCel. `visible: false` hides a series. DIGEST: one cost query. See skill reports."New value: +"Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (use short ids like a/b/c); put human labels in `alias`. Cost inherits metricId/currency/groupBy from reportContext; usage requires metricId (omit groupBy = ungrouped). Budget groupBy is explicit (budget VD bqName); it does not inherit reportContext.groupBy. Cost/usage inherit conditionsCel. `visible: false` hides a series. DIGEST: one cost query. See skill reports."

changedInput schema / properties / context / description

Previous value: -"Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as \"a user\", \"the customer\", or \"an account\". Example: \"Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution.\""New value: +"A few words on why you are calling this tool, for the server developer's analytics. Describe people and things by role, such as \"a customer\". Do not quote the user or include names, emails, or other personal details."

changedInput schema / properties / scout / description

Previous value: -"Scout persona NAME (from list_scouts) — preferred — or its id. Null clears the assignment; omitted leaves it unchanged."New value: +"Scout persona NAME (from list_scouts) or its id. Null clears the assignment; omitted leaves it unchanged."

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "queries",
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "queries",
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "DIVIDER",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      },
-      "useDashboardGroupBy": {
-        "default": true,
-        "description": "Use `reportContext.groupBy` as this DIGEST's root group-by (default true). Set false to override: the report context group-by is ignored for this widget and the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root. `false` requires at least one dimension (a non-empty `additionalGroupBy` or a `queries[0].groupBy`). Example: useDashboardGroupBy: false + additionalGroupBy: [\"cos_namespace_reallocated\",\"cos_workload_name\"] → root cos_namespace_reallocated, report context key ignored for this widget only.",
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "queries",
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "DIVIDER",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` by default, or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Use datePreset or reportContext when available.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Use display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      },
+      "useDashboardGroupBy": {
+        "default": true,
+        "description": "Use `reportContext.groupBy` as this DIGEST's root group-by (default true). Set false to override: the report context group-by is ignored for this widget and the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root. `false` requires at least one dimension (a non-empty `additionalGroupBy` or a `queries[0].groupBy`). Example: useDashboardGroupBy: false + additionalGroupBy: [\"cos_namespace_reallocated\",\"cos_workload_name\"] → root cos_namespace_reallocated, report context key ignored for this widget only.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / required

Previous value: -[
-  "reportId",
-  "context",
-  "llm_model"
-]New value: +[
+  "reportId",
+  "context"
+]

Changed6 schema fields changedNov 12, 2026

removedInput schema / properties / context / allOf

Removed value: -[
-  {
-    "$ref": "#/definitions/ReportMcpContext"
-  }
-]

changedInput schema / properties / context / description

Previous value: -"Deprecated alias for `reportContext`; supported temporarily for backward compatibility. Do not send both fields."New value: +"Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as \"a user\", \"the customer\", or \"an account\". Example: \"Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution.\""

addedInput schema / properties / context / type
```
Added value: +"string"
```

addedInput schema / properties / conversation_id

Added value: +{
+  "description": "The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.",
+  "type": "string"
+}

addedInput schema / properties / llm_model

Added value: +{
+  "description": "The model identifier you are running as, for example \"claude-opus-4-8\" or \"gpt-5.2\". Pass \"unknown\" if you are not certain. Recorded for the server developer's analytics.",
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "reportId"
-]New value: +[
+  "reportId",
+  "context",
+  "llm_model"
+]

Changed9 schema fields changedNov 5, 2026

removedInput schema / definitions / ReportMcpContext / properties / groupBy / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / definitions / ReportMcpContext / properties / groupBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / definitions / ReportMcpContext / properties / metricId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / definitions / ReportMcpContext / properties / metricId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / definitions / ReportMcpContext / properties / scopeId / anyOf

Removed value: -[
-  {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / definitions / ReportMcpContext / properties / scopeId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedInput schema / properties / schedule / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "NOW",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "UNSCHEDULED",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "firstRunAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "First send date as ISO-8601 UTC datetime, or null to clear. The time of day is ignored."
-      },
-      "mode": {
-        "const": "SCHEDULED",
-        "type": "string"
-      },
-      "period": {
-        "description": "Recurrence: DAILY, WEEKDAYS, WEEKLY, or MONTHLY. WEEKLY requires `weekday`.",
-        "enum": [
-          "DAILY",
-          "WEEKDAYS",
-          "WEEKLY",
-          "MONTHLY"
-        ],
-        "type": "string"
-      },
-      "weekday": {
-        "description": "Day of week for WEEKLY: 0 = Sunday … 6 = Saturday. Required when period is WEEKLY.",
-        "maximum": 6,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "mode",
-      "period"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "NOW",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "UNSCHEDULED",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "firstRunAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "First send date as ISO-8601 UTC datetime, or null to clear. The time of day is ignored."
+      },
+      "mode": {
+        "const": "SCHEDULED",
+        "type": "string"
+      },
+      "period": {
+        "description": "Recurrence: DAILY, WEEKDAYS, WEEKLY, or MONTHLY. WEEKLY requires `weekday`.",
+        "enum": [
+          "DAILY",
+          "WEEKDAYS",
+          "WEEKLY",
+          "MONTHLY"
+        ],
+        "type": "string"
+      },
+      "weekday": {
+        "description": "Day of week for WEEKLY: 0 = Sunday … 6 = Saturday. Required when period is WEEKLY.",
+        "maximum": 6,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode",
+      "period"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / scout

Added value: +{
+  "anyOf": [
+    {
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Scout persona NAME (from list_scouts) — preferred — or its id. Null clears the assignment; omitted leaves it unchanged."
+}

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      },
-      "useDashboardGroupBy": {
-        "default": true,
-        "description": "Use `reportContext.groupBy` as this DIGEST's root group-by (default true). Set false to override: the report context group-by is ignored for this widget and the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root. `false` requires at least one dimension (a non-empty `additionalGroupBy` or a `queries[0].groupBy`). Example: useDashboardGroupBy: false + additionalGroupBy: [\"cos_namespace_reallocated\",\"cos_workload_name\"] → root cos_namespace_reallocated, report context key ignored for this widget only.",
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "DIVIDER",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      },
+      "useDashboardGroupBy": {
+        "default": true,
+        "description": "Use `reportContext.groupBy` as this DIGEST's root group-by (default true). Set false to override: the report context group-by is ignored for this widget and the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root. `false` requires at least one dimension (a non-empty `additionalGroupBy` or a `queries[0].groupBy`). Example: useDashboardGroupBy: false + additionalGroupBy: [\"cos_namespace_reallocated\",\"cos_workload_name\"] → root cos_namespace_reallocated, report context key ignored for this widget only.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "queries",
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 22, 2026

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "$ref": "#/definitions/ReportMcpQueries"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      },
+      "useDashboardGroupBy": {
+        "default": true,
+        "description": "Use `reportContext.groupBy` as this DIGEST's root group-by (default true). Set false to override: the report context group-by is ignored for this widget and the first `additionalGroupBy` item (or `queries[0].groupBy`) becomes the root. `false` requires at least one dimension (a non-empty `additionalGroupBy` or a `queries[0].groupBy`). Example: useDashboardGroupBy: false + additionalGroupBy: [\"cos_namespace_reallocated\",\"cos_workload_name\"] → root cos_namespace_reallocated, report context key ignored for this widget only.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 19, 2026

changedInput schema / definitions / ReportMcpQueries / description

Previous value: -"Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost inherits metricId/currency/groupBy from reportContext; usage requires metricId (omit groupBy = ungrouped). Cost/usage inherit conditionsCel. `visible: false` hides a series. DIGEST: one cost query. See skill reports."New value: +"Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost inherits metricId/currency/groupBy from reportContext; usage requires metricId (omit groupBy = ungrouped). Budget groupBy is explicit (budget VD bqName); it does not inherit reportContext.groupBy. Cost/usage inherit conditionsCel. `visible: false` hides a series. DIGEST: one cost query. See skill reports."

Changed8 schema fields changedOct 17, 2026

addedInput schema / definitions

Added value: +{
+  "ReportMcpContext": {
+    "properties": {
+      "conditionsCel": {
+        "description": "Report-wide CEL filter merged into cost and usage widgets. Omit or empty string for no report-level filter.",
+        "type": "string"
+      },
+      "currency": {
+        "anyOf": [
+          {
+            "enum": [
+              "USD",
+              "EUR",
+              "GBP",
+              "CNY",
+              "KRW"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "datePreset": {
+        "anyOf": [
+          {
+            "enum": [
+              "TRAILING_90_DAYS",
+              "TRAILING_30_DAYS",
+              "TRAILING_45_DAYS",
+              "TRAILING_7_DAYS",
+              "TRAILING_3_DAYS",
+              "TRAILING_1_DAYS",
+              "TRAILING_14_WEEKS",
+              "MTD",
+              "QTD",
+              "YTD",
+              "CURRENT_MONTH",
+              "CURRENT_QUARTER",
+              "CURRENT_YEAR",
+              "LAST_WEEK",
+              "LAST_MONTH",
+              "LAST_6_MONTHS",
+              "LAST_12_MONTHS",
+              "LAST_4_YEARS",
+              "LAST_3_MONTHS",
+              "LAST_INVOICE_MONTH"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."
+      },
+      "endDate": {
+        "anyOf": [
+          {
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "groupBy": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Default group-by axis inherited by widgets that omit `groupBy`. For DIGEST, this is the root hierarchy axis — put deeper levels in `additionalGroupBy`."
+      },
+      "metricId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Default metric inherited by widget cost queries that omit `metricId`."
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Applied report-wide unless a widget overrides."
+      },
+      "startDate": {
+        "anyOf": [
+          {
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Used only when `datePreset` is null; ISO date (YYYY-MM-DD)."
+      }
+    },
+    "type": "object"
+  },
+  "ReportMcpQueries": {
+    "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost inherits metricId/currency/groupBy from reportContext; usage requires metricId (omit groupBy = ungrouped). Cost/usage inherit conditionsCel. `visible: false` hides a series. DIGEST: one cost query. See skill reports.",
+    "items": {
+      "additionalProperties": {},
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "type": "array"
+  }
+}

addedInput schema / properties / context / allOf

Added value: +[
+  {
+    "$ref": "#/definitions/ReportMcpContext"
+  }
+]

removedInput schema / properties / context / properties

Removed value: -{
-  "conditionsCel": {
-    "description": "Report-wide CEL filter merged into cost widgets. Omit or empty string for no report-level filter.",
-    "type": "string"
-  },
-  "currency": {
-    "anyOf": [
-      {
-        "enum": [
-          "USD",
-          "EUR",
-          "GBP",
-          "CNY",
-          "KRW"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "datePreset": {
-    "anyOf": [
-      {
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."
-  },
-  "endDate": {
-    "anyOf": [
-      {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "groupBy": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default group-by axis inherited by widgets that omit `groupBy`. For DIGEST, this is the root hierarchy axis — put deeper levels in `additionalGroupBy`."
-  },
-  "metricId": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default metric inherited by widget cost queries that omit `metricId`."
-  },
-  "scopeId": {
-    "anyOf": [
-      {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Optional saved team scope id (from list_teams). Applied report-wide unless a widget overrides."
-  },
-  "startDate": {
-    "anyOf": [
-      {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Used only when `datePreset` is null; ISO date (YYYY-MM-DD)."
-  }
-}

removedInput schema / properties / context / type
```
Removed value: -"object"
```

addedInput schema / properties / reportContext / allOf

Added value: +[
+  {
+    "$ref": "#/definitions/ReportMcpContext"
+  }
+]

removedInput schema / properties / reportContext / properties

Removed value: -{
-  "conditionsCel": {
-    "description": "Report-wide CEL filter merged into cost widgets. Omit or empty string for no report-level filter.",
-    "type": "string"
-  },
-  "currency": {
-    "anyOf": [
-      {
-        "enum": [
-          "USD",
-          "EUR",
-          "GBP",
-          "CNY",
-          "KRW"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "datePreset": {
-    "anyOf": [
-      {
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."
-  },
-  "endDate": {
-    "anyOf": [
-      {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "groupBy": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default group-by axis inherited by widgets that omit `groupBy`. For DIGEST, this is the root hierarchy axis — put deeper levels in `additionalGroupBy`."
-  },
-  "metricId": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Default metric inherited by widget cost queries that omit `metricId`."
-  },
-  "scopeId": {
-    "anyOf": [
-      {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Optional saved team scope id (from list_teams). Applied report-wide unless a widget overrides."
-  },
-  "startDate": {
-    "anyOf": [
-      {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ],
-    "description": "Used only when `datePreset` is null; ISO date (YYYY-MM-DD)."
-  }
-}

removedInput schema / properties / reportContext / type
```
Removed value: -"object"
```

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_1_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "$ref": "#/definitions/ReportMcpQueries"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 15, 2026

changedInput schema / properties / context / properties / datePreset / description

Previous value: -"Default date preset inherited when a widget omits date fields. Prefer this over startDate/endDate whenever an available preset matches."New value: +"Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."

changedInput schema / properties / reportContext / properties / datePreset / description

Previous value: -"Default date preset inherited when a widget omits date fields. Prefer this over startDate/endDate whenever an available preset matches."New value: +"Default date preset inherited when a widget omits date fields. Forecast: CURRENT_MONTH / CURRENT_QUARTER / CURRENT_YEAR. Prefer this over startDate/endDate."

Changed2 schema fields changedOct 12, 2026

changedInput schema / properties / context / properties / currency / anyOf

Previous value: -[
-  {
-    "enum": [
-      "USD",
-      "EUR",
-      "GBP",
-      "CNY"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "USD",
+      "EUR",
+      "GBP",
+      "CNY",
+      "KRW"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / reportContext / properties / currency / anyOf

Previous value: -[
-  {
-    "enum": [
-      "USD",
-      "EUR",
-      "GBP",
-      "CNY"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "USD",
+      "EUR",
+      "GBP",
+      "CNY",
+      "KRW"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedSep 29, 2026

changedInput schema / properties / schedule / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "NOW",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "UNSCHEDULED",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "firstRunAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "First send time as ISO-8601 UTC datetime, or null to clear"
-      },
-      "mode": {
-        "const": "SCHEDULED",
-        "type": "string"
-      },
-      "period": {
-        "description": "Recurrence: DAILY, WEEKDAYS, WEEKLY, or MONTHLY. WEEKLY requires `weekday`.",
-        "enum": [
-          "DAILY",
-          "WEEKDAYS",
-          "WEEKLY",
-          "MONTHLY"
-        ],
-        "type": "string"
-      },
-      "weekday": {
-        "description": "Day of week for WEEKLY: 0 = Sunday … 6 = Saturday. Required when period is WEEKLY.",
-        "maximum": 6,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "mode",
-      "period"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "NOW",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "const": "UNSCHEDULED",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "firstRunAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "First send date as ISO-8601 UTC datetime, or null to clear. The time of day is ignored."
+      },
+      "mode": {
+        "const": "SCHEDULED",
+        "type": "string"
+      },
+      "period": {
+        "description": "Recurrence: DAILY, WEEKDAYS, WEEKLY, or MONTHLY. WEEKLY requires `weekday`.",
+        "enum": [
+          "DAILY",
+          "WEEKDAYS",
+          "WEEKLY",
+          "MONTHLY"
+        ],
+        "type": "string"
+      },
+      "weekday": {
+        "description": "Day of week for WEEKLY: 0 = Sunday … 6 = Saturday. Required when period is WEEKLY.",
+        "maximum": 6,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode",
+      "period"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / tagIds

Added value: +{
+  "description": "Replaces the full tag list. Omit to keep stored tags; pass [] to clear. Pass existing tag IDs from `list_tags`, and/or new tag objects `{ name, color? }` (created in the org if missing; color defaults to #6366F1).",
+  "items": {
+    "anyOf": [
+      {
+        "description": "Existing tag ID",
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "color": {
+            "default": "#6366F1",
+            "description": "Hex color for the new tag (defaults to #6366F1)",
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "type": "array"
+}

Changed3 schema fields changedSep 23, 2026

changedInput schema / properties / context / properties / datePreset / anyOf

Previous value: -[
-  {
-    "enum": [
-      "TRAILING_90_DAYS",
-      "TRAILING_30_DAYS",
-      "TRAILING_45_DAYS",
-      "TRAILING_7_DAYS",
-      "TRAILING_3_DAYS",
-      "TRAILING_14_WEEKS",
-      "MTD",
-      "QTD",
-      "YTD",
-      "CURRENT_MONTH",
-      "CURRENT_QUARTER",
-      "CURRENT_YEAR",
-      "LAST_WEEK",
-      "LAST_MONTH",
-      "LAST_6_MONTHS",
-      "LAST_12_MONTHS",
-      "LAST_4_YEARS",
-      "LAST_3_MONTHS",
-      "LAST_INVOICE_MONTH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "TRAILING_90_DAYS",
+      "TRAILING_30_DAYS",
+      "TRAILING_45_DAYS",
+      "TRAILING_7_DAYS",
+      "TRAILING_3_DAYS",
+      "TRAILING_1_DAYS",
+      "TRAILING_14_WEEKS",
+      "MTD",
+      "QTD",
+      "YTD",
+      "CURRENT_MONTH",
+      "CURRENT_QUARTER",
+      "CURRENT_YEAR",
+      "LAST_WEEK",
+      "LAST_MONTH",
+      "LAST_6_MONTHS",
+      "LAST_12_MONTHS",
+      "LAST_4_YEARS",
+      "LAST_3_MONTHS",
+      "LAST_INVOICE_MONTH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / reportContext / properties / datePreset / anyOf

Previous value: -[
-  {
-    "enum": [
-      "TRAILING_90_DAYS",
-      "TRAILING_30_DAYS",
-      "TRAILING_45_DAYS",
-      "TRAILING_7_DAYS",
-      "TRAILING_3_DAYS",
-      "TRAILING_14_WEEKS",
-      "MTD",
-      "QTD",
-      "YTD",
-      "CURRENT_MONTH",
-      "CURRENT_QUARTER",
-      "CURRENT_YEAR",
-      "LAST_WEEK",
-      "LAST_MONTH",
-      "LAST_6_MONTHS",
-      "LAST_12_MONTHS",
-      "LAST_4_YEARS",
-      "LAST_3_MONTHS",
-      "LAST_INVOICE_MONTH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "TRAILING_90_DAYS",
+      "TRAILING_30_DAYS",
+      "TRAILING_45_DAYS",
+      "TRAILING_7_DAYS",
+      "TRAILING_3_DAYS",
+      "TRAILING_1_DAYS",
+      "TRAILING_14_WEEKS",
+      "MTD",
+      "QTD",
+      "YTD",
+      "CURRENT_MONTH",
+      "CURRENT_QUARTER",
+      "CURRENT_YEAR",
+      "LAST_WEEK",
+      "LAST_MONTH",
+      "LAST_6_MONTHS",
+      "LAST_12_MONTHS",
+      "LAST_4_YEARS",
+      "LAST_3_MONTHS",
+      "LAST_INVOICE_MONTH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "CURRENT_MONTH",
-          "CURRENT_QUARTER",
-          "CURRENT_YEAR",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface. Allowed values: 5, 10, 15, or 20.",
-        "type": "number"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_1_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface (integer 1–100). Applied at every tree level.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedSep 8, 2026

changedInput schema / properties / context / properties / datePreset / anyOf

Previous value: -[
-  {
-    "enum": [
-      "TRAILING_90_DAYS",
-      "TRAILING_30_DAYS",
-      "TRAILING_45_DAYS",
-      "TRAILING_7_DAYS",
-      "TRAILING_3_DAYS",
-      "TRAILING_14_WEEKS",
-      "MTD",
-      "QTD",
-      "YTD",
-      "LAST_WEEK",
-      "LAST_MONTH",
-      "LAST_6_MONTHS",
-      "LAST_12_MONTHS",
-      "LAST_4_YEARS",
-      "LAST_3_MONTHS",
-      "LAST_INVOICE_MONTH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "TRAILING_90_DAYS",
+      "TRAILING_30_DAYS",
+      "TRAILING_45_DAYS",
+      "TRAILING_7_DAYS",
+      "TRAILING_3_DAYS",
+      "TRAILING_14_WEEKS",
+      "MTD",
+      "QTD",
+      "YTD",
+      "CURRENT_MONTH",
+      "CURRENT_QUARTER",
+      "CURRENT_YEAR",
+      "LAST_WEEK",
+      "LAST_MONTH",
+      "LAST_6_MONTHS",
+      "LAST_12_MONTHS",
+      "LAST_4_YEARS",
+      "LAST_3_MONTHS",
+      "LAST_INVOICE_MONTH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / reportContext / properties / datePreset / anyOf

Previous value: -[
-  {
-    "enum": [
-      "TRAILING_90_DAYS",
-      "TRAILING_30_DAYS",
-      "TRAILING_45_DAYS",
-      "TRAILING_7_DAYS",
-      "TRAILING_3_DAYS",
-      "TRAILING_14_WEEKS",
-      "MTD",
-      "QTD",
-      "YTD",
-      "LAST_WEEK",
-      "LAST_MONTH",
-      "LAST_6_MONTHS",
-      "LAST_12_MONTHS",
-      "LAST_4_YEARS",
-      "LAST_3_MONTHS",
-      "LAST_INVOICE_MONTH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "TRAILING_90_DAYS",
+      "TRAILING_30_DAYS",
+      "TRAILING_45_DAYS",
+      "TRAILING_7_DAYS",
+      "TRAILING_3_DAYS",
+      "TRAILING_14_WEEKS",
+      "MTD",
+      "QTD",
+      "YTD",
+      "CURRENT_MONTH",
+      "CURRENT_QUARTER",
+      "CURRENT_YEAR",
+      "LAST_WEEK",
+      "LAST_MONTH",
+      "LAST_6_MONTHS",
+      "LAST_12_MONTHS",
+      "LAST_4_YEARS",
+      "LAST_3_MONTHS",
+      "LAST_INVOICE_MONTH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface. Allowed values: 5, 10, 15, or 20.",
-        "type": "number"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 50,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 50,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "CURRENT_MONTH",
+          "CURRENT_QUARTER",
+          "CURRENT_YEAR",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface. Allowed values: 5, 10, 15, or 20.",
+        "type": "number"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedAug 28, 2026

changedInput schema / properties / widgets / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dashboardId": {
-        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "DASHBOARD_PDF",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "dashboardId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "additionalProperties": false,
-        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
-        "properties": {
-          "chartType": {
-            "default": "WATERFALL",
-            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
-            "enum": [
-              "WATERFALL",
-              "TABLE",
-              "KPI_BREAKDOWN"
-            ],
-            "type": "string"
-          },
-          "enabled": {
-            "default": true,
-            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
-            "type": "boolean"
-          },
-          "from": {
-            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "type": {
-        "const": "GRAPH_SNAPSHOT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aggBy": {
-        "default": "Month",
-        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
-        "enum": [
-          "Hour",
-          "Day",
-          "Week",
-          "Month",
-          "Period"
-        ],
-        "type": "string"
-      },
-      "datePreset": {
-        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "flopN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "from": {
-        "description": "Widget-level start date override. Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "to": {
-        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topN": {
-        "default": 5,
-        "maximum": 50,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "type": {
-        "const": "TOP_FLOP",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contentMarkdown": {
-        "maxLength": 10000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "title": {
-        "default": "",
-        "type": "string"
-      },
-      "type": {
-        "const": "TEXT",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "contentMarkdown"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "additionalGroupBy": {
-        "default": [],
-        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "aggBy": {
-        "default": "Month",
-        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
-        "enum": [
-          "Week",
-          "Month"
-        ],
-        "type": "string"
-      },
-      "compare": {
-        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
-        "properties": {
-          "from": {
-            "description": "Comparison period start date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "to": {
-            "description": "Comparison period end date.",
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ],
-        "type": "object"
-      },
-      "datePreset": {
-        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
-        "enum": [
-          "TRAILING_90_DAYS",
-          "TRAILING_30_DAYS",
-          "TRAILING_45_DAYS",
-          "TRAILING_7_DAYS",
-          "TRAILING_3_DAYS",
-          "TRAILING_14_WEEKS",
-          "MTD",
-          "QTD",
-          "YTD",
-          "LAST_WEEK",
-          "LAST_MONTH",
-          "LAST_6_MONTHS",
-          "LAST_12_MONTHS",
-          "LAST_4_YEARS",
-          "LAST_3_MONTHS",
-          "LAST_INVOICE_MONTH"
-        ],
-        "type": "string"
-      },
-      "description": {
-        "default": "",
-        "type": "string"
-      },
-      "display": {
-        "default": "tree",
-        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
-        "enum": [
-          "tree",
-          "table",
-          "summary"
-        ],
-        "type": "string"
-      },
-      "enableAiInvestigation": {
-        "default": false,
-        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
-        "type": "boolean"
-      },
-      "from": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "limit": {
-        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
-        "maximum": 1000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "minAbsoluteDiff": {
-        "default": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "minRelativeDiff": {
-        "default": 5,
-        "minimum": 0,
-        "type": "number"
-      },
-      "queries": {
-        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "scopeId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
-      },
-      "title": {
-        "default": "Cost changes",
-        "type": "string"
-      },
-      "to": {
-        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "topLargestAbsoluteChange": {
-        "default": 20,
-        "description": "How many largest-absolute-change nodes to surface. Allowed values: 5, 10, 15, or 20.",
-        "type": "number"
-      },
-      "type": {
-        "const": "DIGEST",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "dashboardId": {
+        "description": "Id of the dashboard to render as a PDF (from `search`/`get`).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Optional period override for the PDF. Omit to inherit the report (and destination) period.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Optional custom range start (YYYY-MM-DD). Use with to instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Optional custom range end (inclusive, YYYY-MM-DD). Use with from instead of datePreset.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "DASHBOARD_PDF",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "dashboardId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "additionalProperties": false,
+        "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+        "properties": {
+          "chartType": {
+            "default": "WATERFALL",
+            "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+            "enum": [
+              "WATERFALL",
+              "TABLE",
+              "KPI_BREAKDOWN"
+            ],
+            "type": "string"
+          },
+          "enabled": {
+            "default": true,
+            "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+            "type": "boolean"
+          },
+          "from": {
+            "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "type": {
+        "const": "GRAPH_SNAPSHOT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aggBy": {
+        "default": "Month",
+        "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+        "enum": [
+          "Hour",
+          "Day",
+          "Week",
+          "Month",
+          "Period"
+        ],
+        "type": "string"
+      },
+      "datePreset": {
+        "description": "Widget-level period override (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Use either datePreset OR explicit from/to, not both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "flopN": {
+        "default": 5,
+        "maximum": 50,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "from": {
+        "description": "Widget-level start date override. Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "to": {
+        "description": "Widget-level end date override (inclusive). Omit to inherit report context period.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topN": {
+        "default": 5,
+        "maximum": 50,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "const": "TOP_FLOP",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contentMarkdown": {
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "title": {
+        "default": "",
+        "type": "string"
+      },
+      "type": {
+        "const": "TEXT",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "contentMarkdown"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "additionalGroupBy": {
+        "default": [],
+        "description": "Deeper DIGEST hierarchy levels AFTER the root groupBy, in order. Root axis is `reportContext.groupBy` (preferred) or `queries[0].groupBy` when overriding. Example: reportContext.groupBy=\"cos_environment\" + additionalGroupBy=[\"cos_sub_account_id\",\"cos_service_name\"] → tree path environment → project → service.",
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "aggBy": {
+        "default": "Month",
+        "description": "DIGEST time grain: Week or Month (default Month). Never Period (use TOP_FLOP for whole-period movers).",
+        "enum": [
+          "Week",
+          "Month"
+        ],
+        "type": "string"
+      },
+      "compare": {
+        "description": "Required only with explicit from/to when not using datePreset or reportContext. Prefer datePreset / reportContext.",
+        "properties": {
+          "from": {
+            "description": "Comparison period start date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          },
+          "to": {
+            "description": "Comparison period end date.",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "datePreset": {
+        "description": "Widget-level period override for scheduled DIGESTs (same DatePreset as dashboards, e.g. LAST_WEEK). Omit to inherit `reportContext.datePreset` / startDate/endDate. Mutually exclusive with explicit from/to/compare — do not set both.",
+        "enum": [
+          "TRAILING_90_DAYS",
+          "TRAILING_30_DAYS",
+          "TRAILING_45_DAYS",
+          "TRAILING_7_DAYS",
+          "TRAILING_3_DAYS",
+          "TRAILING_14_WEEKS",
+          "MTD",
+          "QTD",
+          "YTD",
+          "LAST_WEEK",
+          "LAST_MONTH",
+          "LAST_6_MONTHS",
+          "LAST_12_MONTHS",
+          "LAST_4_YEARS",
+          "LAST_3_MONTHS",
+          "LAST_INVOICE_MONTH"
+        ],
+        "type": "string"
+      },
+      "description": {
+        "default": "",
+        "type": "string"
+      },
+      "display": {
+        "default": "tree",
+        "description": "DIGEST presentation: \"tree\" (default, change tree only — faster), \"summary\" (LLM executive narrative — slower; opt-in AI summary), or \"table\" (flat table). Set \"summary\" when the user wants the AI write-up.",
+        "enum": [
+          "tree",
+          "table",
+          "summary"
+        ],
+        "type": "string"
+      },
+      "enableAiInvestigation": {
+        "default": false,
+        "description": "When true, deepest-leaf cost movers get per-node AI investigation before delivery (async analysis_agent_run — noticeably slower). Default false. Independent of display: \"summary\" (executive narrative). Prefer display: \"summary\" alone for a written overview; enable this only when the user wants deep node analysis.",
+        "type": "boolean"
+      },
+      "from": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "limit": {
+        "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups.",
+        "maximum": 1000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "minAbsoluteDiff": {
+        "default": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "minRelativeDiff": {
+        "default": 5,
+        "minimum": 0,
+        "type": "number"
+      },
+      "queries": {
+        "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. On report widgets prefer sparse `{ type: \"cost\", name: \"a\", alias?, filterCel? }` and inherit metricId / currency / groupBy / period from `reportContext`. DIGEST: exactly one `{ type: \"cost\", ... }`. Call get_skill skillId: \"reports\" for examples.",
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "scopeId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+      },
+      "title": {
+        "default": "Cost changes",
+        "type": "string"
+      },
+      "to": {
+        "description": "Only for one-off custom ranges (YYYY-MM-DD). Omit to inherit report context. Do not set when datePreset is set.",
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "topLargestAbsoluteChange": {
+        "default": 20,
+        "description": "How many largest-absolute-change nodes to surface. Allowed values: 5, 10, 15, or 20.",
+        "type": "number"
+      },
+      "type": {
+        "const": "DIGEST",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

First observedAug 19, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true, but the description goes well beyond them: it names the confirmation gate before mutating schedule/widgets/destinations or resuming to ACTIVE, discloses that schedule.mode NOW converts the report to on-demand ACTIVE and sends immediately, and warns that a singular `widget` key is silently ignored. These are non-obvious side effects an agent could not infer from the schema alone.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and trigger are front-loaded, which is good, but the body is a dense block that repeats schema text nearly verbatim (tagIds color default #6366F1, destinations non-empty/replaces-wholesale) instead of spending those sentences on new information. The DANGER ZONE rule is buried mid-paragraph where a skimming agent may miss it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 14-parameter destructive mutation with no output schema, the description covers the essential decision points: what is preserved, what is replaced, which changes need confirmation, and where to look up DIGEST/schedule details. It does not describe what the response returns (e.g., the updated report vs. a diff), which would close the last gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns a bump by explaining replacement semantics for widgets ('replaces the widget list wholesale, with type inside each widget'), the silent-ignore rule for `widget`, and the merge behavior for same-type destinations ('share one execution... exclusive sentinels stay separate'). Some of the tagIds/destinations text merely restates the schema descriptions verbatim, which caps it below 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource with scope: 'Apply declarative partial changes to one non-archived report.' The non-archived constraint and the 'partial patch / omitted fields preserved' framing immediately distinguish it from create_report and archive_report.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit trigger ('Use when the user asks to change an existing report's content, schedule, or destinations'), an explicit exclusion ('Archived restore is forbidden in MCP'), and a routing rule to the get_skill reports guide for content/schedule semantics. It also segments the risky cases (DANGER ZONE) from the safe ones (pure pause plus metadata/reportContext edits apply immediately).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Costory: Your Finops MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?