@lerianstudio/matcher-mcp 5.0.0-beta.34 → 5.0.0-beta.36

package/dist/spec/openapi.yaml

@@ -2860,7 +2860,7 @@ components:
       additionalProperties: false
       properties:
         amount:
-          description: "Enrichment: the exception transaction's amount as a decimal string in the transaction's currency. Present on list rows whose transaction still exists; absent on the get-by-id/resolution paths and when the transaction was deleted."
+          description: "Enrichment: the exception transaction's amount as a decimal string in the transaction's currency. Present on list rows and get-by-id when the transaction still exists."
           examples:
             - "1250.50"
           type: string
@@ -2870,7 +2870,7 @@ components:
             - user@example.com
           type: string
         contextId:
-          description: "Enrichment: id of the reconciliation context the exception's source belongs to (UUID). Present on list rows whose transaction and source still exist; powers the global triage queue's context attribution."
+          description: "Enrichment: id of the reconciliation context the exception's source belongs to (UUID). Present on list rows and get-by-id when the transaction and source still exist; powers the global triage queue's context attribution."
           examples:
             - 550e8400-e29b-41d4-a716-446655440004
           type: string
@@ -2880,7 +2880,7 @@ components:
             - "2025-01-15T10:30:00Z"
           type: string
         currency:
-          description: "Enrichment: ISO 4217 currency code of the exception transaction's amount. Present on list rows whose transaction still exists."
+          description: "Enrichment: ISO 4217 currency code of the exception transaction's amount. Present on list rows and get-by-id when the transaction still exists."
           examples:
             - USD
           type: string
@@ -2942,6 +2942,9 @@ components:
           examples:
             - 550e8400-e29b-41d4-a716-446655440002
           type: string
+        settlement:
+          $ref: "#/components/schemas/ExceptionSettlementResponse"
+          description: Settlement figures for a fee break (expected vs credited and the signed difference), derived from the live fee-variance snapshot recorded for the exception's transaction. Present on get-by-id only, and only when the snapshot and the transaction amount are both available in the same currency.
         severity:
           description: "Severity level: LOW and MEDIUM are informational, HIGH needs prompt review, CRITICAL requires immediate action"
           enum:
@@ -2953,10 +2956,15 @@ components:
             - HIGH
           type: string
         sourceId:
-          description: "Enrichment: id of the reconciliation source the exception transaction belongs to (UUID). Present on list rows whose transaction still exists."
+          description: "Enrichment: id of the reconciliation source the exception transaction belongs to (UUID). Present on list rows and get-by-id when the transaction still exists."
           examples:
             - 550e8400-e29b-41d4-a716-446655440003
           type: string
+        sourceName:
+          description: "Enrichment: display name of the reconciliation source. Present on get-by-id when the transaction and its source still exist."
+          examples:
+            - Bank feed
+          type: string
         status:
           description: "Lifecycle status: OPEN (unhandled), ASSIGNED (owned by a user), PENDING_RESOLUTION (a resolution is in flight), RESOLVED (closed out)"
           enum:
@@ -2968,7 +2976,7 @@ components:
             - OPEN
           type: string
         transactionDate:
-          description: "Enrichment: the exception transaction's value date as an RFC 3339 timestamp. Present on list rows whose transaction still exists."
+          description: "Enrichment: the exception transaction's value date as an RFC 3339 timestamp. Present on list rows and get-by-id when the transaction still exists."
           examples:
             - "2025-01-14T00:00:00Z"
           type: string
@@ -2990,6 +2998,35 @@ components:
         - createdAt
         - updatedAt
       type: object
+    ExceptionSettlementResponse:
+      additionalProperties: false
+      properties:
+        credited:
+          description: Amount actually credited (the transaction amount), as a decimal string
+          examples:
+            - "95.00"
+          type: string
+        currency:
+          description: ISO 4217 currency code of the settlement amounts (the transaction's currency)
+          examples:
+            - BRL
+          type: string
+        difference:
+          description: Signed difference credited minus expected, as a decimal string; negative when the credit fell short
+          examples:
+            - "-2.00"
+          type: string
+        expected:
+          description: Amount the transaction should have credited under the expected fee, as a decimal string
+          examples:
+            - "97.00"
+          type: string
+      required:
+        - expected
+        - credited
+        - difference
+        - currency
+      type: object
     ExportCountResponse:
       additionalProperties: false
       properties:
@@ -11878,7 +11915,7 @@ paths:
         - Exception
   /v1/exceptions/{exceptionId}:
     get:
-      description: Retrieves a single exception by its ID.
+      description: Retrieves a single exception by its ID, including the amount/currency/date/source/context of its transaction and, for fee breaks, the expected vs credited settlement figures.
       operationId: getException
       parameters:
         - description: Exception ID (UUID)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerianstudio/matcher-mcp",
-  "version": "5.0.0-beta.34",
+  "version": "5.0.0-beta.36",
   "type": "module",
   "description": "Model Context Protocol server for the Matcher reconciliation engine",
   "license": "Apache-2.0",