@pam-ai/pam-ordo-contracts 3.35.0 → 3.37.0

package/dist/generated.d.ts

@@ -263,6 +263,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inbox/ro-snooze-settings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the authenticated User's Repair Order auto-snooze preferences
+         * @description Returns whether Ordo snoozes the caller's owned work automatically when a Repair Order opens or closes at the selected rooftop. Values the User has never set report the product defaults: snooze on RO open, do not snooze on RO close. An auto-snooze has no scheduled return; the work comes back when the Customer writes, and a Repair Order close wakes it unless the close preference is on.
+         */
+        get: operations["getRoSnoozeSettings"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inbox/commands/create-customer": {
         parameters: {
             query?: never;
@@ -627,6 +647,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inbox/commands/set-ro-snooze-preference": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set the authenticated User's rooftop-specific Repair Order auto-snooze preferences
+         * @description Replaces both preferences for the caller at the selected rooftop. Only work the User owns when the Repair Order transition arrives is affected, and only transitions accepted after the change. Reusing an operationId with a different payload returns a conflict.
+         */
+        post: operations["setRoSnoozePreference"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inbox/commands/register-desktop-push-subscription": {
         parameters: {
             query?: never;
@@ -1561,6 +1601,8 @@ export interface components {
             kind: string;
             /** @description Optional terminal outcome for a call or voicemail Interaction, carried from the source record. Older calls and sources without an authoritative outcome omit it. A reader must not infer answered from absence or from the Interaction kind alone. */
             callOutcome?: components["schemas"]["CallTerminalOutcomeV1"];
+            /** @description Present only when the source marked this Interaction as sent automatically. Absent means a person wrote it or the source did not say. */
+            automation?: components["schemas"]["InteractionAutomationV1"];
             channel?: string | null;
             /** @enum {string} */
             direction: "INBOUND" | "OUTBOUND" | "INTERNAL";
@@ -1952,8 +1994,19 @@ export interface components {
             recipientUserExternalId?: string;
             /** @description Optional terminal telephony outcome for kind call or voicemail. Producers must not infer it from a transient ringing state or from an absent recording. Missing means outcome was not authoritatively established, not that the call was answered. Existing voicemail producers may omit it during the additive rollout. */
             callOutcome?: components["schemas"]["CallTerminalOutcomeV1"];
+            /** @description Set by the producer that generated the message automatically. Omit it for a message a person wrote, even one sent under an advisor's name. */
+            automation?: components["schemas"]["InteractionAutomationV1"];
             dynamoLocator?: components["schemas"]["ProducerDynamoLocatorV1"];
         };
+        /** @description Marks an Interaction a system sent automatically, so consumers never infer it from the body or the sender. `ro_status_text` is the Repair Order status text sent to the Customer under the advisor's name when an RO opens or is finished; Ordo auto-snoozes the owner's work on it when the owner asked for that. */
+        InteractionAutomationV1: {
+            /** @enum {string} */
+            kind: "ro_status_text";
+            /** @enum {string} */
+            repairOrderTransition: "RO_OPENED" | "RO_CLOSED";
+            /** @description The DMS appointment the text was about, when the producer knows it. */
+            externalAppointmentId?: string;
+        };
         ProducerRepairOrderTransitionV1: {
             /** @enum {string} */
             transition: "RO_OPENED" | "RO_CLOSED";
@@ -2259,6 +2312,14 @@ export interface components {
             /** @description Explicit User setting, or null to inherit the rooftop default. */
             override: boolean | null;
         };
+        SetRoSnoozePreferenceCommand: {
+            operationId: string;
+            clientOrgId: string;
+            /** @description Snooze owned work when a Repair Order opens on it. */
+            autoSnoozeNewRo: boolean;
+            /** @description Snooze owned open work when its Repair Order closes, and keep snoozed work snoozed instead of waking it. */
+            autoSnoozeClosedRo: boolean;
+        };
         WebPushSubscriptionKeys: {
             p256dh: string;
             auth: string;
@@ -2706,6 +2767,23 @@ export interface components {
                 effectiveEnabled: boolean;
             };
         };
+        RoSnoozeSettingsResponse: {
+            data: {
+                clientOrgId: string;
+                autoSnoozeNewRo: boolean;
+                autoSnoozeClosedRo: boolean;
+            };
+        };
+        RoSnoozePreferenceResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                clientOrgId: string;
+                autoSnoozeNewRo: boolean;
+                autoSnoozeClosedRo: boolean;
+            };
+        };
         DesktopPushSubscriptionResult: {
             data: {
                 operationId: string;
@@ -2831,6 +2909,16 @@ export interface components {
                 "application/json": components["schemas"]["DesktopNotificationPreferenceResult"];
             };
         };
+        /** @description Applied or idempotently replayed Repair Order auto-snooze preferences. */
+        RoSnoozePreferenceApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["RoSnoozePreferenceResult"];
+            };
+        };
         /** @description Registered, refreshed, or idempotently replayed browser subscription. */
         DesktopPushSubscriptionRegistered: {
             headers: {
@@ -3058,6 +3146,11 @@ export interface components {
                 "application/json": components["schemas"]["SetDesktopNotificationPreferenceCommand"];
             };
         };
+        SetRoSnoozePreferenceCommand: {
+            content: {
+                "application/json": components["schemas"]["SetRoSnoozePreferenceCommand"];
+            };
+        };
         RegisterDesktopPushSubscriptionCommand: {
             content: {
                 "application/json": components["schemas"]["RegisterDesktopPushSubscriptionCommand"];
@@ -3526,10 +3619,13 @@ export interface operations {
                  * @description Narrow to Customers by the state of their car, using the same three values and the same meanings as the Conversation list: OPEN is a currently active repair order, CLOSED has had one and has none now, NONE never had one.
                  *     This is what makes an omitted query answerable. "Everyone with a car in the shop right now" is a question an advisor actually has, and it is bounded by the service drive rather than by the size of the rooftop; "everyone" is not, which is why browsing without either a query or a roState is refused.
                  *     An EMPTY ARRAY IS A 400, not an unfiltered browse. Presence is not a filter: `?roState=` names no state, so it would satisfy the at-least-one rule while asking for exactly the unbounded page that rule exists to refuse — and it is the shape a client reaches by serialising an empty selection rather than omitting the parameter, so it arrives by accident rather than by intent.
+                 *     CLOSED AND NONE ARE MINE-ONLY BROWSES (since 3.36.0). They are accepted only without a query and with relationship=MINE, where the reader's own Conversations bound the answer: an advisor's book is a list somebody can open onto, and "every Customer at the rooftop who has no car in the shop" is not. The same states with EVERYONE or ALL, or alongside a query, remain a 400. A MINE browse considers at most the reader's 2,000 most recently assigned owned Conversations.
                  */
                 roState?: ("OPEN" | "CLOSED" | "NONE")[];
                 /**
-                 * @description RECENT_REPAIR_ORDER puts the most recently opened repair order first, which is the order a service drive works in — the car that just arrived is the call that has not been made yet. NAME is the stable alphabetical order a search result wants.
+                 * @description RECENT_REPAIR_ORDER puts the most recent repair order first, which is the order a service drive works in — the car that just arrived is the call that has not been made yet. NAME is the stable alphabetical order a search result wants.
+                 *     Recency is the repair order's appointment date, then when PAM first recorded it. Not openedAt: most source systems never report one, and an order nobody can rank would sort as noise. On a MINE browse that spans several roState values, Customers with an OPEN order come first, then CLOSED by their latest order, then NONE; each group is newest first.
+                 *     A BROWSE IS ONLY EVER RANKED BY RECENCY (since 3.36.0). Without a query there is no name the reader typed to put first, and the directory pages a browse in repair-order order, so sort=NAME without a query is a 400 rather than a request that is silently answered in another order.
                  *     Defaults to NAME when a query is given and RECENT_REPAIR_ORDER when one is not, because a browse has no relevance to fall back on.
                  */
                 sort?: "NAME" | "RECENT_REPAIR_ORDER";
@@ -3628,6 +3724,34 @@ export interface operations {
             503: components["responses"]["ServiceUnavailable"];
         };
     };
+    getRoSnoozeSettings: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Effective Repair Order auto-snooze preferences for the selected rooftop. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RoSnoozeSettingsResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
     createInboxCustomer: {
         parameters: {
             query?: never;
@@ -4080,6 +4204,27 @@ export interface operations {
             503: components["responses"]["ServiceUnavailable"];
         };
     };
+    setRoSnoozePreference: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["SetRoSnoozePreferenceCommand"];
+        responses: {
+            200: components["responses"]["RoSnoozePreferenceApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
     registerDesktopPushSubscription: {
         parameters: {
             query?: never;