@remit/api-openapi-spec 0.0.77 → 0.0.78

package/openapi.json

@@ -1291,26 +1291,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": [
-                    "items"
-                  ],
-                  "properties": {
-                    "continuationToken": {
-                      "allOf": [
-                        {
-                          "$ref": "#/components/schemas/String800"
-                        }
-                      ],
-                      "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
-                    },
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/RemitImap.MailboxResponse"
-                      }
-                    }
-                  }
+                  "$ref": "#/components/schemas/RemitImap.MailboxListResponse"
                 }
               }
             }
@@ -1693,7 +1674,7 @@
     "/accounts/{accountId}/organize": {
       "post": {
         "operationId": "OrganizeOperations_createOrganizeJob",
-        "description": "Start a one-time \"all like these\" back-apply: match the corpus against the given predicate and apply the action to every match, in one pass. Returns immediately with an organizeJobId; poll GET /accounts/{accountId}/organize/{organizeJobId} for state and counts. Never creates a Filter or FilterAnchor row (RFC 034 recap).",
+        "description": "Start a one-time \"all like these\" back-apply: match the corpus against the given predicate and apply the action to every match, in one pass. Returns immediately with an organizeJobId; poll GET /accounts/{accountId}/organize/{organizeJobId} for state and counts. Never creates a Filter row (RFC 034 recap).",
         "parameters": [
           {
             "name": "accountId",
@@ -3866,26 +3847,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": [
-                    "items"
-                  ],
-                  "properties": {
-                    "continuationToken": {
-                      "allOf": [
-                        {
-                          "$ref": "#/components/schemas/String800"
-                        }
-                      ],
-                      "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
-                    },
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/RemitImap.ThreadMessageResponse"
-                      }
-                    }
-                  }
+                  "$ref": "#/components/schemas/RemitImap.ThreadMessageListResponse"
                 }
               }
             }
@@ -5248,26 +5210,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": [
-                    "items"
-                  ],
-                  "properties": {
-                    "continuationToken": {
-                      "allOf": [
-                        {
-                          "$ref": "#/components/schemas/String800"
-                        }
-                      ],
-                      "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
-                    },
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/RemitImap.OutboxMessageResponse"
-                      }
-                    }
-                  }
+                  "$ref": "#/components/schemas/RemitImap.OutboxMessageListResponse"
                 }
               }
             }
@@ -5716,139 +5659,6 @@
         }
       }
     },
-    "/search/semantic": {
-      "get": {
-        "operationId": "SemanticSearchOperations_semanticSearch",
-        "description": "Run a semantic vector search across the caller's indexed messages.",
-        "parameters": [
-          {
-            "name": "query",
-            "in": "query",
-            "required": true,
-            "description": "Free-form natural-language query",
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "mailboxId",
-            "in": "query",
-            "required": false,
-            "description": "Restrict results to a single mailbox",
-            "schema": {
-              "$ref": "#/components/schemas/UUID"
-            }
-          },
-          {
-            "name": "sentDateFrom",
-            "in": "query",
-            "required": false,
-            "description": "Lower bound on sentDate (epoch seconds, inclusive)",
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          {
-            "name": "sentDateTo",
-            "in": "query",
-            "required": false,
-            "description": "Upper bound on sentDate (epoch seconds, inclusive)",
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          {
-            "name": "hasAttachment",
-            "in": "query",
-            "required": false,
-            "description": "Restrict to messages with or without attachments",
-            "schema": {
-              "type": "boolean"
-            }
-          },
-          {
-            "name": "hasStars",
-            "in": "query",
-            "required": false,
-            "description": "Restrict to starred or unstarred messages",
-            "schema": {
-              "type": "boolean"
-            }
-          },
-          {
-            "name": "isRead",
-            "in": "query",
-            "required": false,
-            "description": "Restrict to read or unread messages",
-            "schema": {
-              "type": "boolean"
-            }
-          },
-          {
-            "name": "category",
-            "in": "query",
-            "required": false,
-            "description": "Restrict results to a single header-derived category",
-            "schema": {
-              "$ref": "#/components/schemas/RemitImap.MessageCategory"
-            }
-          },
-          {
-            "name": "limit",
-            "in": "query",
-            "required": false,
-            "description": "Maximum number of results to return",
-            "schema": {
-              "type": "integer",
-              "format": "int32"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "The request has succeeded.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/RemitImap.SemanticSearchResult"
-                      }
-                    }
-                  },
-                  "required": [
-                    "items"
-                  ]
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "The request carried no usable credential. `code` is `unauthorized`.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ApiError"
-                }
-              }
-            }
-          }
-        },
-        "x-amazon-apigateway-integration": {
-          "type": "aws_proxy",
-          "httpMethod": "POST",
-          "passthroughBehavior": "when_no_match",
-          "uri": {
-            "Fn::Sub": "arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/arn:aws:lambda:${AWS::Region}:${AWS::AccountId}:function:{{HandlerFunctionName}}/invocations"
-          }
-        }
-      }
-    },
     "/system/update": {
       "get": {
         "operationId": "SystemOperations_getSystemUpdate",
@@ -6192,26 +6002,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": [
-                    "items"
-                  ],
-                  "properties": {
-                    "continuationToken": {
-                      "allOf": [
-                        {
-                          "$ref": "#/components/schemas/String800"
-                        }
-                      ],
-                      "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
-                    },
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/RemitImap.ThreadMessageResponse"
-                      }
-                    }
-                  }
+                  "$ref": "#/components/schemas/RemitImap.ThreadMessageListResponse"
                 }
               }
             }
@@ -7188,6 +6979,7 @@
         "type": "object",
         "required": [
           "bodyPartId",
+          "partPath",
           "mediaType",
           "mediaSubtype",
           "sizeOctets",
@@ -7204,6 +6996,12 @@
             "description": "Primary identifier",
             "readOnly": true
           },
+          "partPath": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Storage path of the part within its message: '0' is the root, otherwise the IMAP section number (e.g., '1', '1.2', '2.1.3'). '<path>.0' is the root of the forwarded message a message/rfc822 part at <path> carries, which is not an IMAP section.",
+            "readOnly": true
+          },
           "mediaType": {
             "allOf": [
               {
@@ -8262,7 +8060,7 @@
         "required": [
           "accountConfig",
           "accounts",
-          "semanticSearchEnabled"
+          "buildCommit"
         ],
         "properties": {
           "accountConfig": {
@@ -8280,6 +8078,10 @@
             },
             "description": "Associated email accounts"
           },
+          "buildCommit": {
+            "type": "string",
+            "description": "The commit the serving build was made from, or `dev` for a build made outside CI and git"
+          },
           "pendingImport": {
             "allOf": [
               {
@@ -8287,10 +8089,6 @@
               }
             ],
             "description": "Absent unless a configuration import is still waiting on folders IMAP has not produced yet (#1021). Nothing polls a separate route for it."
-          },
-          "semanticSearchEnabled": {
-            "type": "boolean",
-            "description": "Whether this instance stores a vector for every message — SEARCH_EMBEDDING_PROVIDER is anything but `off`. False is a setting an operator turns on (`remit semantic on`), not a failure: the Organize semantic widen and semantic (anchor) filters read stored vectors and have none, so they render an off state rather than an empty result. It rides the config read because it is a property of the deployment, not of a query (#1068)."
           }
         },
         "description": "Full configuration description including accounts"
@@ -8751,7 +8549,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterScope"
               }
             ],
-            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again. The semantic anchor stays immutable regardless — repointing it would silently change what a saved filter matches with nothing visible changing, which deserves a new filter instead."
+            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again."
           },
           "expiresAt": {
             "type": "string",
@@ -8763,7 +8561,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterMatchOperator"
               }
             ],
-            "description": "How literalClauses combine. Meaningless when literalClauses is empty.",
+            "description": "How literalClauses combine.",
             "default": "And"
           },
           "literalClauses": {
@@ -8771,8 +8569,8 @@
             "items": {
               "$ref": "#/components/schemas/RemitImap.FilterClause"
             },
-            "description": "Literal from/subject/has-words predicate clauses (RFC 031). Empty when the filter relies solely on its semantic anchor (see hasAnchor).",
-            "default": []
+            "minItems": 1,
+            "description": "Literal from/subject/has-words predicate clauses (RFC 031). A filter carries at least one."
           },
           "actionLabelId": {
             "type": "string",
@@ -8783,17 +8581,9 @@
             "type": "string",
             "description": "Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest actionChangedAt wins. `\"None\"` means no move action.",
             "default": "None"
-          },
-          "anchorMessageId": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/UUID"
-              }
-            ],
-            "description": "Anchor message for a semantic filter — provenance for the persisted anchor the server builds at save time (RFC 034 Decision 2.1). Absent for a purely-literal filter."
           }
         },
-        "description": "Input for creating a filter (RFC 034). `ttl` is omitted — it is derived\nserver-side from `expiresAt` when `scope` is `Temporary` (RFC 034 Decision\n1.3), never client-supplied. `state`, `hasAnchor`, `ruleChangedAt`, and\n`filterId` are all server-derived and excluded by their Read-only visibility.\n\nWhen `anchorMessageId` is set, the server builds and persists the filter's\nsemantic anchor from that message's indexed vectors (RFC 034 Decision 2) and\nsets `hasAnchor`. Absent for a purely-literal filter."
+        "description": "Input for creating a filter (RFC 034). `ttl` is omitted — it is derived\nserver-side from `expiresAt` when `scope` is `Temporary` (RFC 034 Decision\n1.3), never client-supplied. `state`, `ruleChangedAt`, and `filterId` are\nall server-derived and excluded by their Read-only visibility."
       },
       "RemitImap.CreateFilterResponse": {
         "type": "object",
@@ -8804,7 +8594,6 @@
           "scope",
           "state",
           "disabledReason",
-          "hasAnchor",
           "ruleChangedAt",
           "actionChangedAt",
           "matchOperator",
@@ -8848,7 +8637,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterScope"
               }
             ],
-            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again. The semantic anchor stays immutable regardless — repointing it would silently change what a saved filter matches with nothing visible changing, which deserves a new filter instead."
+            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again."
           },
           "expiresAt": {
             "type": "string",
@@ -8873,12 +8662,6 @@
             "default": "None",
             "readOnly": true
           },
-          "hasAnchor": {
-            "type": "boolean",
-            "description": "Whether a sibling FilterAnchor row exists for this filter (RFC 034 Decision 2.3). Lets the index-time worker skip the FilterAnchor `get` entirely for purely-literal filters instead of probing for a row that may not exist.",
-            "default": false,
-            "readOnly": true
-          },
           "ruleChangedAt": {
             "type": "integer",
             "format": "int64",
@@ -8888,7 +8671,7 @@
           "actionChangedAt": {
             "type": "integer",
             "format": "int64",
-            "description": "Epoch seconds, written only when the predicate (literalClauses, hasAnchor) or the action (actionLabelId, actionMailboxId) changes — never on scope, expiresAt, or a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Split out from ruleChangedAt (reader #384): extending a filter's expiry or flipping its scope changes its lifecycle, not what it matches or does, so it must not promote the filter to move-winner.",
+            "description": "Epoch seconds, written only when the predicate (literalClauses) or the action (actionLabelId, actionMailboxId) changes — never on scope, expiresAt, or a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Split out from ruleChangedAt (reader #384): extending a filter's expiry or flipping its scope changes its lifecycle, not what it matches or does, so it must not promote the filter to move-winner.",
             "readOnly": true
           },
           "matchOperator": {
@@ -8897,7 +8680,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterMatchOperator"
               }
             ],
-            "description": "How literalClauses combine. Meaningless when literalClauses is empty.",
+            "description": "How literalClauses combine.",
             "default": "And"
           },
           "literalClauses": {
@@ -8905,8 +8688,8 @@
             "items": {
               "$ref": "#/components/schemas/RemitImap.FilterClause"
             },
-            "description": "Literal from/subject/has-words predicate clauses (RFC 031). Empty when the filter relies solely on its semantic anchor (see hasAnchor).",
-            "default": []
+            "minItems": 1,
+            "description": "Literal from/subject/has-words predicate clauses (RFC 031). A filter carries at least one."
           },
           "actionLabelId": {
             "type": "string",
@@ -9417,7 +9200,7 @@
           "ListId",
           "FromDomain"
         ],
-        "description": "Message attribute a FilterClause matches against — RFC 031's Tier 0 literal predicates plus the RFC 038 D2 additions (list membership and sender domain). Every member is matched vector-free at index time and in the back-apply corpus projection."
+        "description": "Message attribute a FilterClause matches against — RFC 031's Tier 0 literal predicates plus the RFC 038 D2 additions (list membership and sender domain). Every member is matched at index time and in the back-apply corpus projection."
       },
       "RemitImap.FilterDisabledReason": {
         "type": "string",
@@ -9447,7 +9230,6 @@
           "scope",
           "state",
           "disabledReason",
-          "hasAnchor",
           "ruleChangedAt",
           "actionChangedAt",
           "matchOperator",
@@ -9490,7 +9272,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterScope"
               }
             ],
-            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again. The semantic anchor stays immutable regardless — repointing it would silently change what a saved filter matches with nothing visible changing, which deserves a new filter instead."
+            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again."
           },
           "expiresAt": {
             "type": "string",
@@ -9515,12 +9297,6 @@
             "default": "None",
             "readOnly": true
           },
-          "hasAnchor": {
-            "type": "boolean",
-            "description": "Whether a sibling FilterAnchor row exists for this filter (RFC 034 Decision 2.3). Lets the index-time worker skip the FilterAnchor `get` entirely for purely-literal filters instead of probing for a row that may not exist.",
-            "default": false,
-            "readOnly": true
-          },
           "ruleChangedAt": {
             "type": "integer",
             "format": "int64",
@@ -9530,7 +9306,7 @@
           "actionChangedAt": {
             "type": "integer",
             "format": "int64",
-            "description": "Epoch seconds, written only when the predicate (literalClauses, hasAnchor) or the action (actionLabelId, actionMailboxId) changes — never on scope, expiresAt, or a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Split out from ruleChangedAt (reader #384): extending a filter's expiry or flipping its scope changes its lifecycle, not what it matches or does, so it must not promote the filter to move-winner.",
+            "description": "Epoch seconds, written only when the predicate (literalClauses) or the action (actionLabelId, actionMailboxId) changes — never on scope, expiresAt, or a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Split out from ruleChangedAt (reader #384): extending a filter's expiry or flipping its scope changes its lifecycle, not what it matches or does, so it must not promote the filter to move-winner.",
             "readOnly": true
           },
           "matchOperator": {
@@ -9539,7 +9315,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterMatchOperator"
               }
             ],
-            "description": "How literalClauses combine. Meaningless when literalClauses is empty.",
+            "description": "How literalClauses combine.",
             "default": "And"
           },
           "literalClauses": {
@@ -9547,8 +9323,8 @@
             "items": {
               "$ref": "#/components/schemas/RemitImap.FilterClause"
             },
-            "description": "Literal from/subject/has-words predicate clauses (RFC 031). Empty when the filter relies solely on its semantic anchor (see hasAnchor).",
-            "default": []
+            "minItems": 1,
+            "description": "Literal from/subject/has-words predicate clauses (RFC 031). A filter carries at least one."
           },
           "actionLabelId": {
             "type": "string",
@@ -9823,6 +9599,29 @@
         },
         "description": "The id, name, and color of a label applied to a message — embedded on message/thread read responses (issue #26). Never the full LabelResponse: a read-time attachment carries no filterCount."
       },
+      "RemitImap.MailboxListResponse": {
+        "type": "object",
+        "required": [
+          "items"
+        ],
+        "properties": {
+          "continuationToken": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/String800"
+              }
+            ],
+            "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RemitImap.MailboxResponse"
+            }
+          }
+        },
+        "description": "A page of an account's mailboxes."
+      },
       "RemitImap.MailboxResponse": {
         "type": "object",
         "required": [
@@ -10285,11 +10084,6 @@
             "description": "Server receipt timestamp (INTERNALDATE)",
             "readOnly": true
           },
-          "messageIdHeader": {
-            "type": "string",
-            "description": "Message-ID header value for quick reference",
-            "readOnly": true
-          },
           "status": {
             "allOf": [
               {
@@ -10329,6 +10123,11 @@
             "description": "Structured sender-authenticity signal derived from DKIM headers at classification time. Absent for messages classified before this field was introduced — absence means no signal.",
             "readOnly": true
           },
+          "messageIdHeader": {
+            "type": "string",
+            "description": "Message-ID header value for quick reference",
+            "readOnly": true
+          },
           "autoMoved": {
             "allOf": [
               {
@@ -10586,15 +10385,7 @@
                 "$ref": "#/components/schemas/UUID"
               }
             ],
-            "description": "Back-apply this standing filter instead of the predicate in this body. The server reads the filter's persisted predicate, action and FilterAnchor, runs the pass over the inbox, and skips a move another active filter outranks, as index time does. The predicate and action fields of this body are ignored when it is set."
-          },
-          "anchorMessageId": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/UUID"
-              }
-            ],
-            "description": "Anchor message for the semantic half — \"all like this one\". Absent for a purely-literal back-apply. The anchor vector is pooled transiently from this message's indexed chunk vectors and never written to a FilterAnchor row."
+            "description": "Back-apply this standing filter instead of the predicate in this body. The server reads the filter's persisted predicate and action, runs the pass over the inbox, and skips a move another active filter outranks, as index time does. The predicate and action fields of this body are ignored when it is set."
           },
           "matchOperator": {
             "allOf": [
@@ -10610,14 +10401,9 @@
             "items": {
               "$ref": "#/components/schemas/RemitImap.FilterClause"
             },
-            "description": "Literal from/subject/has-words clauses (RFC 031), reusing the Filter predicate shape. Empty when the back-apply relies solely on the semantic anchor.",
+            "description": "Literal from/subject/has-words clauses (RFC 031), reusing the Filter predicate shape.",
             "default": []
           },
-          "similarityThreshold": {
-            "type": "number",
-            "format": "double",
-            "description": "Cosine cut-off for the semantic match. Absent uses the server default (the same threshold the index-time filter pipeline applies)."
-          },
           "actionLabelId": {
             "type": "string",
             "description": "Label applied to every matching message — additive action (RFC 034 Decision 3.1). The `\"None\"` sentinel means no label action.",
@@ -10629,7 +10415,7 @@
             "default": "None"
           }
         },
-        "description": "The predicate + action for a one-time \"all like these\" back-apply (RFC 034\nrecap, #1278). A distinct model, deliberately NOT a Filter: it carries no\n`scope`, `expiresAt`, or `name`, so it structurally cannot create a standing\nrule. The anchor is derived transiently from `anchorMessageId`'s existing chunk\nvectors at match time and never persisted as a FilterAnchor row."
+        "description": "The predicate + action for a one-time \"all like these\" back-apply (RFC 034\nrecap, #1278). A distinct model, deliberately NOT a Filter: it carries no\n`scope`, `expiresAt`, or `name`, so it structurally cannot create a standing\nrule."
       },
       "RemitImap.OrganizeJobResponse": {
         "type": "object",
@@ -10639,10 +10425,8 @@
           "userId",
           "state",
           "filterId",
-          "anchorMessageId",
           "matchOperator",
           "literalClauses",
-          "similarityThreshold",
           "actionLabelId",
           "actionMailboxId",
           "matchedCount",
@@ -10692,12 +10476,6 @@
             "default": "None",
             "readOnly": true
           },
-          "anchorMessageId": {
-            "type": "string",
-            "description": "Snapshot of the anchor message id, or the `\"None\"` sentinel for a purely-literal back-apply. A sentinel, not an optional field, so the persisted entity has no optional attributes (RFC 032).",
-            "default": "None",
-            "readOnly": true
-          },
           "matchOperator": {
             "allOf": [
               {
@@ -10717,13 +10495,6 @@
             "default": [],
             "readOnly": true
           },
-          "similarityThreshold": {
-            "type": "number",
-            "format": "double",
-            "description": "Snapshot of the semantic cut-off applied for this run",
-            "default": 0.75,
-            "readOnly": true
-          },
           "actionLabelId": {
             "type": "string",
             "description": "Snapshot of the additive label action, or `\"None\"`",
@@ -10806,14 +10577,6 @@
               "type": "string"
             },
             "description": "Ids of the matching messages, bounded to the same cap the apply pass uses"
-          },
-          "semanticUnavailable": {
-            "type": "boolean",
-            "description": "True when the semantic widen could not run because this deployment ships no vector pipeline (self-host without sqlite-vec / the embedding model). The matched set is then the literal matches only, or empty for an anchor-only predicate; literal search is unaffected. Absent on deployments where the widen ran."
-          },
-          "semanticIndexEmpty": {
-            "type": "boolean",
-            "description": "True when the widen ran but this account's semantic index held nothing to answer with — no vectors at all, or none yet for the anchor message. A zero count is then a fact about the index, which is still filling, rather than about the rule. Absent when the index answered."
           }
         },
         "description": "Response body for POST /accounts/{accountId}/organize/preview — the messages the same matcher would apply the action to, without applying it. Bounded server-side."
@@ -10966,6 +10729,29 @@
         ],
         "description": "Where an attachment is between being promised and being sendable.\n\nThere is no third state and no absence: a row exists from the moment room is\nclaimed, so the cap can be enforced against rows in one transaction rather\nthan against bytes that may or may not have landed yet."
       },
+      "RemitImap.OutboxMessageListResponse": {
+        "type": "object",
+        "required": [
+          "items"
+        ],
+        "properties": {
+          "continuationToken": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/String800"
+              }
+            ],
+            "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RemitImap.OutboxMessageResponse"
+            }
+          }
+        },
+        "description": "A page of the current account's outbox messages."
+      },
       "RemitImap.OutboxMessageResponse": {
         "type": "object",
         "required": [
@@ -11169,7 +10955,9 @@
       "RemitImap.QuarantineListResponse": {
         "type": "object",
         "required": [
-          "entries"
+          "entries",
+          "warnings",
+          "warningsTotal"
         ],
         "properties": {
           "entries": {
@@ -11178,9 +10966,21 @@
               "$ref": "#/components/schemas/RemitImap.QuarantineResponse"
             },
             "description": "Quarantined messages, newest first."
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RemitImap.SyncWarningResponse"
+            },
+            "description": "The 200 newest sync warnings that have failed at least BODY_SYNC_MAX_ATTEMPTS rounds, newest first. One failing server quirk writes a row per message, so the list is capped."
+          },
+          "warningsTotal": {
+            "type": "integer",
+            "format": "int32",
+            "description": "Every sync warning at or past the attempt threshold, counting those beyond the cap on `warnings`."
           }
         },
-        "description": "Everything quarantined for the current user, newest first. The list is small by design — a mailbox with a growing quarantine list is a bug being reported, not a page to paginate."
+        "description": "Everything quarantined for the current user, newest first, beside the sync warnings that have failed enough rounds to surface. The quarantine list is small by design — a mailbox with a growing quarantine list is a bug being reported, not a page to paginate."
       },
       "RemitImap.QuarantineMimeNode": {
         "type": "object",
@@ -11473,88 +11273,6 @@
         },
         "description": "Input for updating a mailbox. Rename (IMAP sync) is triggered only when `fullPath` is provided. The `muted` flag and the `displayNameOverride` override can be updated independently without triggering IMAP machinery; pass `null` to clear either. The canonical role a folder fills is appointed separately — see FolderRoleOperations.appointFolderRole (RFC 032 exclusive-folder-appointment)."
       },
-      "RemitImap.SemanticSearchChunkType": {
-        "type": "string",
-        "enum": [
-          "sender",
-          "recipient",
-          "subject",
-          "attachment",
-          "body",
-          "entities"
-        ],
-        "description": "Allowed chunk types that may be the best match for a semantic-search hit"
-      },
-      "RemitImap.SemanticSearchResult": {
-        "type": "object",
-        "required": [
-          "messageId",
-          "threadId",
-          "score",
-          "matchedChunkType",
-          "mailboxIds"
-        ],
-        "properties": {
-          "messageId": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/UUID"
-              }
-            ],
-            "description": "Matched message id"
-          },
-          "threadId": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/UUID"
-              }
-            ],
-            "description": "Thread id the matched message belongs to"
-          },
-          "score": {
-            "type": "number",
-            "format": "double",
-            "description": "Cosine similarity (or backend-equivalent) of the best matching chunk for this message; higher is more relevant"
-          },
-          "matchedChunkType": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/RemitImap.SemanticSearchChunkType"
-              }
-            ],
-            "description": "Chunk type that produced the best match for this message"
-          },
-          "mailboxIds": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/UUID"
-            },
-            "description": "All mailbox ids the matched message currently lives in"
-          },
-          "fromName": {
-            "type": "string",
-            "description": "Display name of the sender (From header). Present for messages indexed after display-field enrichment was deployed."
-          },
-          "subject": {
-            "type": "string",
-            "description": "Message subject. Present for messages indexed after display-field enrichment was deployed."
-          },
-          "sentDate": {
-            "type": "integer",
-            "format": "int64",
-            "description": "Sent date as Unix epoch seconds. Present for messages indexed after display-field enrichment was deployed."
-          },
-          "category": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/RemitImap.MessageCategory"
-              }
-            ],
-            "description": "Header-derived category of the matched message. Present for messages indexed after category enrichment was deployed; older entries omit it."
-          }
-        },
-        "description": "A single semantic-search hit. Display fields (fromName, subject, sentDate) are denormalized at index time and present for messages indexed after this feature was deployed. Older entries may omit them; clients should render a fallback when absent."
-      },
       "RemitImap.SenderTrust": {
         "type": "string",
         "enum": [
@@ -11673,6 +11391,100 @@
         },
         "description": "Sync trigger response"
       },
+      "RemitImap.SyncWarningResponse": {
+        "type": "object",
+        "required": [
+          "syncWarningId",
+          "accountConfigId",
+          "accountId",
+          "mailboxId",
+          "uidValidity",
+          "uid",
+          "stage",
+          "attempts",
+          "createdAt"
+        ],
+        "properties": {
+          "syncWarningId": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/UUID"
+              }
+            ],
+            "description": "Deterministic v5 identity derived from accountId, mailboxId, uidValidity, uid and stage.",
+            "readOnly": true
+          },
+          "accountConfigId": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/UUID"
+              }
+            ],
+            "description": "Owning account configuration — the user.",
+            "readOnly": true
+          },
+          "accountId": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/UUID"
+              }
+            ],
+            "description": "Mail account the message arrived on.",
+            "readOnly": true
+          },
+          "mailboxId": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/UUID"
+              }
+            ],
+            "description": "Mailbox the message arrived in.",
+            "readOnly": true
+          },
+          "uidValidity": {
+            "type": "integer",
+            "format": "int64",
+            "description": "UIDVALIDITY of the mailbox when the message failed. Only uidValidity + uid names a message forever (RFC 9051 2.3.1.1).",
+            "readOnly": true
+          },
+          "uid": {
+            "type": "integer",
+            "format": "int64",
+            "description": "The IMAP uid that failed.",
+            "readOnly": true
+          },
+          "stage": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RemitImap.SyncWarningStage"
+              }
+            ],
+            "description": "The sync step the message failed at.",
+            "readOnly": true
+          },
+          "attempts": {
+            "type": "integer",
+            "format": "int32",
+            "description": "Rounds that failed on this message so far.",
+            "readOnly": true
+          },
+          "createdAt": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Epoch millis of the first failure.",
+            "readOnly": true
+          }
+        },
+        "description": "One sync warning as the settings surface sees it."
+      },
+      "RemitImap.SyncWarningStage": {
+        "type": "string",
+        "enum": [
+          "Header",
+          "Body"
+        ],
+        "description": "The sync step a message failed at."
+      },
       "RemitImap.SystemUpdateCheck": {
         "type": "object",
         "required": [
@@ -11961,6 +11773,29 @@
         },
         "description": "Connection test result"
       },
+      "RemitImap.ThreadMessageListResponse": {
+        "type": "object",
+        "required": [
+          "items"
+        ],
+        "properties": {
+          "continuationToken": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/String800"
+              }
+            ],
+            "description": "Opaque, server-minted cursor: absent means the first (or last) page, present means resume from here. Echo it back unchanged to fetch the next page. Every listing endpoint that accepts it rejects a token it cannot decode with 400 ValidationError rather than silently restarting from the first page (#136, #172)."
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RemitImap.ThreadMessageResponse"
+            }
+          }
+        },
+        "description": "A page of thread messages."
+      },
       "RemitImap.ThreadMessageResponse": {
         "type": "object",
         "required": [
@@ -12590,7 +12425,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterScope"
               }
             ],
-            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again. The semantic anchor stays immutable regardless — repointing it would silently change what a saved filter matches with nothing visible changing, which deserves a new filter instead."
+            "description": "Standing (permanent) or Temporary (expires). Governs whether expiresAt/ttl are present (RFC 034 Decision 1). Mutable on update (reader #266): switching scope re-derives ttl and re-evaluates state from expiresAt, and bumps ruleChangedAt so a lapsed filter's back-application can be offered again."
           },
           "expiresAt": {
             "type": "string",
@@ -12611,7 +12446,7 @@
                 "$ref": "#/components/schemas/RemitImap.FilterMatchOperator"
               }
             ],
-            "description": "How literalClauses combine. Meaningless when literalClauses is empty.",
+            "description": "How literalClauses combine.",
             "default": "And"
           },
           "literalClauses": {
@@ -12619,8 +12454,8 @@
             "items": {
               "$ref": "#/components/schemas/RemitImap.FilterClause"
             },
-            "description": "Literal from/subject/has-words predicate clauses (RFC 031). Empty when the filter relies solely on its semantic anchor (see hasAnchor).",
-            "default": []
+            "minItems": 1,
+            "description": "Literal from/subject/has-words predicate clauses (RFC 031). A filter carries at least one."
           },
           "actionLabelId": {
             "type": "string",
@@ -12633,7 +12468,7 @@
             "default": "None"
           }
         },
-        "description": "Input for updating a filter (RFC 034, reader #266). The name, predicate,\naction, scope, and expiresAt are all updatable; `ttl` is always\nserver-derived from `scope`/`expiresAt`, never client-supplied, and\n`disabledReason`/`hasAnchor`/`ruleChangedAt`/`actionChangedAt`/`filterId` are\nserver-derived too. `state` takes `Active` or `Disabled`: the user turns a\nfilter off or back on, and turning it on clears `disabledReason`. `Expired`\nis refused; the expiry is set through `scope`/`expiresAt`. A patch touching the predicate, the action, `scope`, or\n`expiresAt` bumps `ruleChangedAt`; a name-only rename never does (RFC 034\nDecision 3.2, reader #266). Only a patch touching the predicate or the\naction bumps `actionChangedAt`, the narrower signal exclusive-move\nprecedence reads (reader #384) — a scope/expiresAt-only edit leaves it\nuntouched.\n\nThe semantic anchor has no field here at all — it is set once, from\n`anchorMessageId`, only on `CreateFilterInput`. Repointing an anchor would\nsilently change what a saved filter matches with nothing visible changing;\nthat deserves a new filter, so the server rejects any attempt to smuggle an\nanchor change through this body (reader #266)."
+        "description": "Input for updating a filter (RFC 034, reader #266). The name, predicate,\naction, scope, and expiresAt are all updatable; `ttl` is always\nserver-derived from `scope`/`expiresAt`, never client-supplied, and\n`disabledReason`/`ruleChangedAt`/`actionChangedAt`/`filterId` are\nserver-derived too. `state` takes `Active` or `Disabled`: the user turns a\nfilter off or back on, and turning it on clears `disabledReason`. `Expired`\nis refused; the expiry is set through `scope`/`expiresAt`. A patch touching the predicate, the action, `scope`, or\n`expiresAt` bumps `ruleChangedAt`; a name-only rename never does (RFC 034\nDecision 3.2, reader #266). Only a patch touching the predicate or the\naction bumps `actionChangedAt`, the narrower signal exclusive-move\nprecedence reads (reader #384) — a scope/expiresAt-only edit leaves it\nuntouched."
       },
       "RemitImap.UpdateFlagsInput": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-spec",
-  "version": "0.0.77",
+  "version": "0.0.78",
   "description": "Remit API OpenAPI 3 document, generated from TypeSpec.",
   "exports": {
     ".": "./openapi.json",