@remit/api-openapi-types 0.0.101 → 0.0.102

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-types",
-  "version": "0.0.101",
+  "version": "0.0.102",
   "type": "module",
   "main": "types.d.ts",
   "types": "types.d.ts",

package/types.d.ts

@@ -248,7 +248,7 @@ current enum emitter anyway, so the wire contract uses the bare form.
     /**
      * A label a classification provider picks for a message: the junk verdicts, priority, and the message categories.
      */
-    export type ClassificationLabel = "Spam" | "Phishing" | "Priority" | "Personal" | "Newsletter" | "Marketing" | "Automated" | "Transactional" | "Social";
+    export type ClassificationLabel = "Spam" | "Phishing" | "Priority" | "Personal" | "Newsletter" | "Marketing" | "Automated" | "Transactional" | "Social" | "ColdOutreach";
     /**
      * Why a classification provider call gave no usable answer.
      */
@@ -257,6 +257,10 @@ current enum emitter anyway, so the wire contract uses the bare form.
      * The classification provider form field a failure points at.
      */
     export type ClassificationField = "ApiKey" | "Model" | "BaseUrl";
+    /**
+     * Header-derived message category. Set by classifyByHeaders during body-sync. Defaults to `uncategorized`, which covers both a message that has not been classified yet and one the classifier declined to categorize; `Message.classificationState` is what tells those apart.
+     */
+    export type MessageCategory = "uncategorized" | "personal" | "newsletter" | "marketing" | "automated" | "transactional" | "social" | "coldOutreach";
     /**
      * Sort order for list operations
      */
@@ -265,10 +269,6 @@ current enum emitter anyway, so the wire contract uses the bare form.
      * Gmail-style star colors for message/thread marking
      */
     export type StarColor = "none" | "yellow" | "orange" | "red" | "purple" | "blue" | "teal" | "green" | "yellow_bang" | "red_bang" | "purple_question" | "blue_info" | "orange_guillemet" | "green_check" | "yellow_check" | "blue_star";
-    /**
-     * Header-derived message category. Set by classifyByHeaders during body-sync. Defaults to `uncategorized`, which covers both a message that has not been classified yet and one the classifier declined to categorize; `Message.classificationState` is what tells those apart.
-     */
-    export type MessageCategory = "uncategorized" | "personal" | "newsletter" | "marketing" | "automated" | "transactional" | "social";
     /**
      * Trust level for the From address, derived at read time from AddressFlags + counters.
      */
@@ -3952,6 +3952,55 @@ field on this resource rather than one more operation.
        */
       fix: string;
     }
+    /**
+     * The classifier's distribution and corrections over mail that arrived on or after `since`, across every account the caller holds.
+     */
+    export interface ClassifierStats {
+      /**
+       * The start of the window, as the request gave it: an ISO 8601 date-time with zone offset.
+       */
+      since: string;
+      /**
+       * Messages that arrived on or after `since` whose body sync classified them.
+       */
+      examined: number;
+      /**
+       * Examined messages per category; a category with none is absent.
+       */
+      byCategory: ClassifierCategoryCount[];
+      /**
+       * Confident scores per label, over the examined messages; a label with none is absent.
+       */
+      byLabel: ClassifierLabelCount[];
+      corrections: ClassifierCorrections;
+    }
+    /**
+     * Examined messages in one category.
+     */
+    export interface ClassifierCategoryCount {
+      category: MessageCategory;
+      count: number;
+    }
+    /**
+     * Confident scores for one label.
+     */
+    export interface ClassifierLabelCount {
+      label: ClassificationLabel;
+      count: number;
+    }
+    /**
+     * Times the reader disagreed with the classifier since `since`.
+     */
+    export interface ClassifierCorrections {
+      /**
+       * Messages the reader reported as spam whose stored scores held no confident `Spam` or `Phishing` score.
+       */
+      spamReportedNotJunk: number;
+      /**
+       * Senders whose `Address.flags.category` override was set on or after `since`.
+       */
+      categoryOverridden: number;
+    }
     /**
      * Tasks due in the requested window, in due order. Unpaginated: the window is the bound.
      */
@@ -5789,6 +5838,10 @@ either way and cannot tell which it received.
        * Body-sync timestamp (epoch millis) the classifier's placement verdict was first decided, whether the verdict was to move the message or to leave it in place. Absent means placement has never been evaluated for this message. Guards `computePlacement` against a re-entrant body-sync pass (`fetchAndGetBody`'s `NoSuchKey` fallback, `syncBodies(..., force: true)`) re-deciding — and possibly reversing — a placement a user has since overridden by hand. `movedByRemit` remains the guard for a message that was placement-decided before this field existed.
        */
       placementDecidedAt?: number;
+      /**
+       * Every score the classification provider gave this message at body sync. Empty when the provider was not asked or gave no answer, and for every message synced before scores were stored. Persistence-only: no response model exposes it.
+       */
+      classifierScores: ClassifierScore[];
       /**
        * Recorded when the user reported this message as spam. Absent means never reported, or reported and then undone (`POST /messages/not-spam` clears it). Independent of the message's current folder — deliberately not derived from "sits in Junk", which is also true of a message Remit moved on its own.
        */
@@ -5851,6 +5904,23 @@ either way and cannot tell which it received.
        */
       decidedAt: number;
     }
+    /**
+     * One label the classification provider scored for a message, as body sync stored it.
+     */
+    export interface ClassifierScore {
+      /**
+       * The label the provider scored.
+       */
+      label: ClassificationLabel;
+      /**
+       * The provider's confidence in `label`, between 0 and 1.
+       */
+      confidence: number;
+      /**
+       * True when `confidence` reached the threshold for the provider's kind of confidence when body sync stored it: 0.7 for a calibrated provider, 0.8 for an advisory one.
+       */
+      confident: boolean;
+    }
     /**
      * Core message entity as the API carries it: the stored row plus the Message-ID header, which is stored on the message's thread row.
      */
@@ -5955,6 +6025,10 @@ either way and cannot tell which it received.
        * Body-sync timestamp (epoch millis) the classifier's placement verdict was first decided, whether the verdict was to move the message or to leave it in place. Absent means placement has never been evaluated for this message. Guards `computePlacement` against a re-entrant body-sync pass (`fetchAndGetBody`'s `NoSuchKey` fallback, `syncBodies(..., force: true)`) re-deciding — and possibly reversing — a placement a user has since overridden by hand. `movedByRemit` remains the guard for a message that was placement-decided before this field existed.
        */
       placementDecidedAt?: number;
+      /**
+       * Every score the classification provider gave this message at body sync. Empty when the provider was not asked or gave no answer, and for every message synced before scores were stored. Persistence-only: no response model exposes it.
+       */
+      classifierScores: ClassifierScore[];
       /**
        * Recorded when the user reported this message as spam. Absent means never reported, or reported and then undone (`POST /messages/not-spam` clears it). Independent of the message's current folder — deliberately not derived from "sits in Junk", which is also true of a message Remit moved on its own.
        */
@@ -8033,6 +8107,16 @@ declare namespace Paths {
       export type $401 = void;
     }
   }
+  namespace GetClassificationStats {
+    export interface QueryParameters {
+      since: string;
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+      export type $401 = void;
+    }
+  }
   namespace ListCalendarTasks {
     export interface QueryParameters {
       from: string;
@@ -9036,6 +9120,14 @@ reader organizes the event, none otherwise.
     data?: Paths.TestClassificationProvider.RequestBody,
     config?: AxiosRequestConfig
   ): OperationResponse<any>;
+  /**
+   * getClassificationStats - Count what the classifier decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
+   */
+  'getClassificationStats'(
+    parameters?: Parameters<Paths.GetClassificationStats.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.GetClassificationStats.Responses.$200>;
   /**
    * listCalendarTasks - Tasks due in a window, across every task collection the caller holds, in due order. Refused with 400 on the same window rules as the event listing.
    */
@@ -10015,6 +10107,16 @@ reader organizes the event, none otherwise.
       config?: AxiosRequestConfig
     ): OperationResponse<any>;
   };
+  ['/classification-stats']: {
+    /**
+     * getClassificationStats - Count what the classifier decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetClassificationStats.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.GetClassificationStats.Responses.$200>;
+  };
   ['/calendar-tasks']: {
     /**
      * listCalendarTasks - Tasks due in a window, across every task collection the caller holds, in due order. Refused with 400 on the same window rules as the event listing.
@@ -10647,6 +10749,10 @@ export type UpdateUserSettingsInput = Components.Schemas.UpdateUserSettingsInput
 export type ClassificationTestInput = Components.Schemas.ClassificationTestInput;
 export type ClassificationTestPassed = Components.Schemas.ClassificationTestPassed;
 export type ClassificationTestFailed = Components.Schemas.ClassificationTestFailed;
+export type ClassifierStats = Components.Schemas.ClassifierStats;
+export type ClassifierCategoryCount = Components.Schemas.ClassifierCategoryCount;
+export type ClassifierLabelCount = Components.Schemas.ClassifierLabelCount;
+export type ClassifierCorrections = Components.Schemas.ClassifierCorrections;
 export type CalendarTaskListResponse = Components.Schemas.CalendarTaskListResponse;
 export type CalendarTask = Components.Schemas.CalendarTask;
 export type CalendarTaskResponse = Components.Schemas.CalendarTaskResponse;
@@ -10700,6 +10806,7 @@ export type MessageRecord = Components.Schemas.MessageRecord;
 export type MessageAuthResult = Components.Schemas.MessageAuthResult;
 export type MessageProviderSpam = Components.Schemas.MessageProviderSpam;
 export type MessageFilterMove = Components.Schemas.MessageFilterMove;
+export type ClassifierScore = Components.Schemas.ClassifierScore;
 export type Message = Components.Schemas.Message;
 export type MessageSummaryResponse = Components.Schemas.MessageSummaryResponse;
 export type EnvelopeResponse = Components.Schemas.EnvelopeResponse;
@@ -10810,9 +10917,9 @@ export type ClassificationUnrunnableReason = Components.Schemas.ClassificationUn
 export type ClassificationLabel = Components.Schemas.ClassificationLabel;
 export type ClassificationFailureKind = Components.Schemas.ClassificationFailureKind;
 export type ClassificationField = Components.Schemas.ClassificationField;
+export type MessageCategory = Components.Schemas.MessageCategory;
 export type SortOrder = Components.Schemas.SortOrder;
 export type StarColor = Components.Schemas.StarColor;
-export type MessageCategory = Components.Schemas.MessageCategory;
 export type SenderTrust = Components.Schemas.SenderTrust;
 export type DisplayNameCorrespondence = Components.Schemas.DisplayNameCorrespondence;
 export type MessageStatus = Components.Schemas.MessageStatus;