@remit/api-openapi-spec 0.0.93 → 0.0.94

package/openapi.json

@@ -11957,6 +11957,56 @@
         ],
         "description": "Which mutation a message's placement gave up on. Read it only while\n`syncStatus` is `abandoned` — outside that it is `none` and says nothing,\nthe way `originalUid` says nothing once a placement has settled\n(`docs/architecture/imap-mutations.md` R3).\n\nIt exists because a hand-back erases the evidence: the give-up puts `status`\nback to `active`, and `status` was the only field naming the mutation that\nwas outstanding. Without this the client can see that something was\nabandoned and cannot see what, which is how a move that gave up came to be\nexplained to the user as a failed delete."
       },
+      "RemitImap.MessagePlacementVerdict": {
+        "type": "object",
+        "required": [
+          "action",
+          "confidence",
+          "fromPlacement",
+          "reasons",
+          "dryRun",
+          "decidedAt"
+        ],
+        "properties": {
+          "action": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RemitImap.PlacementAction"
+              }
+            ],
+            "description": "The direction Remit decided to move the message."
+          },
+          "confidence": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RemitImap.PlacementConfidence"
+              }
+            ],
+            "description": "Confidence of the verdict. A Junk arrival not judged junk moves to the Inbox at either confidence, and one judged junk stays in Junk. Outside Junk only a `Confident` verdict moves the message."
+          },
+          "fromPlacement": {
+            "type": "string",
+            "description": "The folder the message was in when the verdict was made: inbox | junk | other."
+          },
+          "reasons": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Deterministic signals the verdict was based on, for diagnostics."
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "True when the dark-ship flag was off, so the move was computed but not enqueued (would-move only). False when a real IMAP move was enqueued."
+          },
+          "decidedAt": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Body-sync timestamp the verdict was decided at (epoch millis)."
+          }
+        },
+        "description": "Remit's placement decision for a message, recorded at body-sync time. Present only when Remit decided to act (action != leave); absent when the message was left in place or synced before placement rolled out. Written in dry-run too, so the dark-ship verdict distribution is queryable before moves are enabled."
+      },
       "RemitImap.MessageReferenceResponse": {
         "type": "object",
         "required": [
@@ -13068,6 +13118,14 @@
         ],
         "description": "Actionable placement verdict — the direction Remit decided to move a message. `leave` is not represented: a left-in-place verdict means the placement sub-model is absent."
       },
+      "RemitImap.PlacementConfidence": {
+        "type": "string",
+        "enum": [
+          "Confident",
+          "Unsure"
+        ],
+        "description": "Confidence of a placement verdict. `Confident` verdicts move mail (when the dark-ship flag is on); `Unsure` verdicts are recorded but never moved."
+      },
       "RemitImap.QuarantineFailureCode": {
         "type": "string",
         "enum": [
@@ -14237,6 +14295,14 @@
               }
             ],
             "description": "Present when the user reported this message as spam and the report has not been undone, projected from the underlying Message row. Backs the \"Reported as spam · Undo\" affordance in list views."
+          },
+          "placementVerdict": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RemitImap.MessagePlacementVerdict"
+              }
+            ],
+            "description": "Remit's placement verdict for this message, projected from the underlying Message row. Absent for a message judged before placement verdicts were recorded, or one Remit left in place."
           }
         },
         "description": "Thread message item returned by list/search operations. `senderTrust` is attached at read time via batch-fetch so the inbox row can render its badge without a per-row round trip. `category` is served from the ThreadMessage row itself, which is also the row the category filter matches, so the badge and the filter cannot disagree."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-spec",
-  "version": "0.0.93",
+  "version": "0.0.94",
   "description": "Remit API OpenAPI 3 document, generated from TypeSpec, and its precompiled request validators.",
   "exports": {
     ".": "./openapi.json",