Previous value: -"Step 2 only: one note (max 120 chars) prepended to every confirmed row's Notes, same as the app's 'Add note to all entries'."New value: +"Step 2 note prepended to confirmed rows (max 120 characters)."

Previous value: -"Step 2 only: true writes the staged rows. Omit it (with previewId absent) to parse and preview without writing."New value: +"Step 2: true writes the staged selection only after user approval."

Previous value: -"Attached CSV/TSV/text file supplied by ChatGPT for step 1. The server downloads and decodes the attachment securely."New value: +"Step 1 ChatGPT attachment; securely downloaded and decoded."

Previous value: -"Legacy fallback for MCP clients that send raw CSV/TSV/text content inline. ChatGPT should use csvContent."New value: +"Step 1 inline CSV/TSV/text fallback; ChatGPT should use csvContent."

Previous value: -"Step 2 only: preview indexes of duplicate-flagged rows the user explicitly wants to keep anyway (the app's 'Keep Both')."New value: +"Step 2 duplicate indexes the user explicitly approved keeping."

Previous value: -"Fallback payment rail for rows where the parser found none (Cash, Check, Bank transfer, Wallet app, Credit/Debit card, Payment processor, or Other)."New value: +"Fallback payment rail only when absent from the parsed row."

Previous value: -"Step 2 only: the previewId returned by the step-1 call."New value: +"Step 2 ID returned by the unexpired preview."

Previous value: -"Step 2 only: user-approved corrections, at most 50 rows. Fields: date (ISO YYYY-MM-DD), source, amount, currency, category, paymentMethod, description, notes, reference, fees, taxCollected, tag."New value: +"Step 2 approved edits; at most 50 selected preview rows."

Previous value: -trueNew value: +false

Previous value: -"Only the user-approved income fields to replace on this staged row: date, source, amount, currency, category, paymentMethod, description, notes, reference, fees, taxCollected, or tag."New value: +"Only approved replacements on this staged row."

Added value: +{
+  "amount": {
+    "description": "Non-zero income amount.",
+    "type": [
+      "number",
+      "string",
+      "boolean"
+    ]
+  },
+  "category": {
+    "description": "Income category.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "currency": {
+    "description": "Currency code.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "date": {
+    "description": "ISO YYYY-MM-DD calendar date.",
+    "type": "string"
+  },
+  "description": {
+    "description": "Income description.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "fees": {
+    "description": "Non-negative platform fees.",
+    "type": [
+      "number",
+      "string",
+      "boolean",
+      "null"
+    ]
+  },
+  "notes": {
+    "description": "Income notes.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "paymentMethod": {
+    "description": "Payment rail.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "reference": {
+    "description": "Income reference.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "source": {
+    "description": "Income source label.",
+    "type": [
+      "string",
+      "number",
+      "boolean"
+    ]
+  },
+  "tag": {
+    "description": "Client/project tag.",
+    "type": [
+      "string",
+      "number",
+      "boolean",
+      "null"
+    ]
+  },
+  "taxCollected": {
+    "description": "Non-negative collected tax.",
+    "type": [
+      "number",
+      "string",
+      "boolean",
+      "null"
+    ]
+  }
+}

Added value: +0

Added value: +50

Previous value: -"Step 2 only: preview row indexes to write. Omit to write all staged rows."New value: +"Step 2 preview row indexes to write; omit for all staged rows."

Previous value: -"Optional client/project tag. In step 1 it pre-fills the staged rows; in step 2 it applies to the confirmed selection."New value: +"Optional client/project tag for staged or confirmed rows."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "preview": {
+            "const": true
+          }
+        },
+        "required": [
+          "preview"
+        ]
+      },
+      "then": {
+        "required": [
+          "previewId",
+          "expiresAt",
+          "entryCount",
+          "entries",
+          "confirmationContract"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "confirmed": {
+            "const": true
+          }
+        },
+        "required": [
+          "confirmed"
+        ]
+      },
+      "then": {
+        "required": [
+          "previewId",
+          "written",
+          "deduped",
+          "failed",
+          "unattempted",
+          "total"
+        ]
+      }
+    }
+  ],
+  "properties": {
+    "confirmationContract": {
+      "type": "string"
+    },
+    "confirmed": {
+      "type": "boolean"
+    },
+    "deduped": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "duplicateCount": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "duplicates": {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "entries": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "date": {
+            "format": "date",
+            "type": "string"
+          },
+          "duplicate": {
+            "type": "boolean"
+          },
+          "index": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "payer": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "entryCount": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "expiresAt": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "expiresInMinutes": {
+      "minimum": 1,
+      "type": "integer"
+    },
+    "failed": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "finalAnswer": {
+      "type": "string"
+    },
+    "idempotentReplay": {
+      "type": "boolean"
+    },
+    "maxChatEntries": {
+      "minimum": 1,
+      "type": "integer"
+    },
+    "message": {
+      "type": "string"
+    },
+    "preview": {
+      "type": "boolean"
+    },
+    "previewId": {
+      "type": "string"
+    },
+    "projectionTruncated": {
+      "type": "boolean"
+    },
+    "refundRowCount": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "rejectedRows": {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "responseGuidance": {
+      "type": "string"
+    },
+    "reviewImportUrl": {
+      "type": "string"
+    },
+    "reviewIncomeUrl": {
+      "type": "string"
+    },
+    "spreadsheetUrl": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "success": {
+      "type": "boolean"
+    },
+    "tooLargeForChat": {
+      "type": "boolean"
+    },
+    "total": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "totalsByCurrency": {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "type": "object"
+    },
+    "unattempted": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "warnings": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "written": {
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "success",
+    "message"
+  ],
+  "type": "object"
+}

Previous value: -{
-  "additionalProperties": true,
-  "description": "Standard ExpenseBot tool result envelope. `message` is the human-readable summary the AI cites; `data` is the structured payload (totals, breakdowns, ids, etc.). On failure, `success` is false and `error` carries a code/message/hint triple.",
-  "properties": {
-    "data": {
-      "additionalProperties": true,
-      "description": "Structured payload. Shape varies per tool — common keys: total, breakdown, comparison, sampleMeta, ids, expenseId, reportId, signupUrl, results.",
-      "type": "object"
-    },
-    "error": {
-      "additionalProperties": true,
-      "description": "Present only when success === false.",
-      "properties": {
-        "code": {
-          "type": "string"
-        },
-        "hint": {
-          "type": "string"
-        },
-        "message": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "message": {
-      "description": "Human-readable result text. Always present on success; prefer rendering this verbatim before any further reasoning.",
-      "type": "string"
-    },
-    "sampleMeta": {
-      "additionalProperties": true,
-      "description": "Set when the underlying dataset was truncated. isTruncated=true means the agent saw a sample of `sampleCount` of `totalCount` rows; aggregate totals are still accurate.",
-      "properties": {
-        "isTruncated": {
-          "type": "boolean"
-        },
-        "sampleCount": {
-          "type": "integer"
-        },
-        "totalCount": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "success": {
-      "description": "False on tool errors; check before reading `data`.",
-      "type": "boolean"
-    }
-  },
-  "type": "object"
-}New value: +null

Previous value: -"Raw CSV/TSV/text content (step 1). On ChatGPT you may pass the attached file reference object directly; the server fetches and decodes the bytes."New value: +"Attached CSV/TSV/text file supplied by ChatGPT for step 1. The server downloads and decodes the attachment securely."

Added value: +{
+  "download_url": {
+    "description": "Temporary HTTPS URL supplied by ChatGPT for downloading the attachment.",
+    "format": "uri",
+    "type": "string"
+  },
+  "file_id": {
+    "description": "Attachment identifier supplied by ChatGPT.",
+    "type": "string"
+  },
+  "file_name": {
+    "description": "Original attachment filename supplied by ChatGPT.",
+    "type": "string"
+  },
+  "mime_type": {
+    "description": "Attachment MIME type supplied by ChatGPT.",
+    "type": "string"
+  }
+}

Added value: +[
+  "download_url",
+  "file_id"
+]

Previous value: -"string"New value: +"object"

Added value: +{
+  "description": "Legacy fallback for MCP clients that send raw CSV/TSV/text content inline. ChatGPT should use csvContent.",
+  "type": "string"
+}

Added value: +"Only the user-approved income fields to replace on this staged row: date, source, amount, currency, category, paymentMethod, description, notes, reference, fees, taxCollected, or tag."