@pam-ai/pam-ordo-contracts 3.30.0 → 3.31.0

package/dist/generated.d.ts

@@ -243,6 +243,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inbox/desktop-notification-settings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the authenticated User's effective desktop-notification setting
+         * @description Returns the selected rooftop's default, the caller's optional rooftop-specific override, and the effective value. A present User override wins over the rooftop default in both directions. Browser permission and device subscription state remain local browser concerns and do not change this product preference.
+         */
+        get: operations["getDesktopNotificationSettings"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inbox/commands/create-customer": {
         parameters: {
             query?: never;
@@ -550,6 +570,60 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inbox/commands/set-desktop-notification-preference": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Set or clear the authenticated User's rooftop-specific desktop-notification override */
+        post: operations["setDesktopNotificationPreference"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/register-desktop-push-subscription": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Register or refresh an account-wide browser push subscription
+         * @description The authenticated User owns the subscription. It can deliver eligible notifications from every rooftop that User can currently access; rooftop and User preferences are still evaluated independently for each notification. An endpoint already owned by another User is never silently rebound.
+         */
+        post: operations["registerDesktopPushSubscription"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/unregister-desktop-push-subscription": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Unregister the authenticated User's browser push subscription */
+        post: operations["unregisterDesktopPushSubscription"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inbox/commands/resolve-mention": {
         parameters: {
             query?: never;
@@ -998,6 +1072,7 @@ export interface components {
             notifications: components["schemas"]["InboxPolicyNotificationRuleV1"][];
             customerMessageNotifications?: components["schemas"]["InboxPolicyCustomerMessageNotificationsV1"];
             emailDelivery?: components["schemas"]["InboxEmailDeliveryPolicyV1"];
+            webPushDelivery?: components["schemas"]["InboxWebPushDeliveryPolicyV1"];
             staffWorkStatus?: components["schemas"]["InboxPolicyStaffWorkStatusV1"];
         };
         /** @description Rooftop activation for authoritative Permissions work status. Missing is normalized as DISPLAY_ONLY. SHADOW records the decision without changing routing; ENFORCED may exclude non-AVAILABLE Users from automatic routing. Manual assignment continues to use manualAssignmentEligible. */
@@ -1014,6 +1089,12 @@ export interface components {
             activatedAt: string;
             kinds: components["schemas"]["NotificationKind"][];
         };
+        /** @description Optional forward-only rooftop default for desktop Web Push. Missing policy or enabled=false defaults delivery off. A User's explicit rooftop override wins over this value in either direction. Only notifications created at or after activatedAt are eligible. */
+        InboxWebPushDeliveryPolicyV1: {
+            enabled: boolean;
+            /** Format: date-time */
+            activatedAt: string;
+        };
         /** @enum {string} */
         RealtimeQueryAreaV1: "inbox" | "conversation" | "customer_notes" | "notifications";
         /** @description Refetch instruction, never canonical state. eventId deduplicates repeated delivery. aggregateVersion is only a hint for the named aggregate and must not suppress independent comment, note, label, or recipient changes. A scope-only invalidation deliberately omits Conversation and aggregate identity, including when a formerly visible Conversation is no longer authorized. Notification areas are recipient-only. No source payloads, message bodies, Customer information, or subscription credentials belong in this frame. */
@@ -2108,6 +2189,32 @@ export interface components {
             /** @description Opaque continuation cursor from the immediately preceding page. */
             cursor?: string;
         };
+        SetDesktopNotificationPreferenceCommand: {
+            operationId: string;
+            clientOrgId: string;
+            /** @description Explicit User setting, or null to inherit the rooftop default. */
+            override: boolean | null;
+        };
+        WebPushSubscriptionKeys: {
+            p256dh: string;
+            auth: string;
+        };
+        RegisterDesktopPushSubscriptionCommand: {
+            operationId: string;
+            clientOrgId: string;
+            subscription: {
+                /** Format: uri */
+                endpoint: string;
+                expirationTime: number | null;
+                keys: components["schemas"]["WebPushSubscriptionKeys"];
+            };
+        };
+        UnregisterDesktopPushSubscriptionCommand: {
+            operationId: string;
+            clientOrgId: string;
+            /** Format: uri */
+            endpoint: string;
+        };
         /**
          * @description Mark the caller's outstanding Mentions on one WorkCycle dealt with.
          *     CONVERSATION-WIDE, NOT PER-MENTION, and the shape is the point. A recipient does not think in Mentions; they think "I have handled this thread". Two colleagues naming the same person in one exchange raises two Mentions, and clearing one of them would leave the row on the Mentions list with nothing on screen to explain why.
@@ -2451,6 +2558,41 @@ export interface components {
                 nextCursor: string | null;
             };
         };
+        DesktopNotificationSettingsResponse: {
+            data: {
+                clientOrgId: string;
+                rooftopDefaultEnabled: boolean;
+                userOverride: boolean | null;
+                effectiveEnabled: boolean;
+                /** Format: date-time */
+                activatedAt: string | null;
+                vapidPublicKey: string;
+            };
+        };
+        DesktopNotificationPreferenceResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                clientOrgId: string;
+                rooftopDefaultEnabled: boolean;
+                userOverride: boolean | null;
+                effectiveEnabled: boolean;
+            };
+        };
+        DesktopPushSubscriptionResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /**
+                 * Format: uuid
+                 * @description Existing subscription identity, or null when unregistration was a no-op.
+                 */
+                subscriptionId: string | null;
+                active: boolean;
+            };
+        };
         ErrorEnvelope: {
             error: {
                 code: string;
@@ -2553,6 +2695,36 @@ export interface components {
                 "application/json": components["schemas"]["DismissNotificationsResult"];
             };
         };
+        /** @description Applied or idempotently replayed desktop-notification preference. */
+        DesktopNotificationPreferenceApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["DesktopNotificationPreferenceResult"];
+            };
+        };
+        /** @description Registered, refreshed, or idempotently replayed browser subscription. */
+        DesktopPushSubscriptionRegistered: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["DesktopPushSubscriptionResult"];
+            };
+        };
+        /** @description Unregistered or idempotently replayed browser subscription. */
+        DesktopPushSubscriptionUnregistered: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["DesktopPushSubscriptionResult"];
+            };
+        };
         /** @description Created or idempotently replayed canonical Customer result. */
         InboxCustomerCreated: {
             headers: {
@@ -2735,6 +2907,21 @@ export interface components {
                 "application/json": components["schemas"]["DismissNotificationsCommand"];
             };
         };
+        SetDesktopNotificationPreferenceCommand: {
+            content: {
+                "application/json": components["schemas"]["SetDesktopNotificationPreferenceCommand"];
+            };
+        };
+        RegisterDesktopPushSubscriptionCommand: {
+            content: {
+                "application/json": components["schemas"]["RegisterDesktopPushSubscriptionCommand"];
+            };
+        };
+        UnregisterDesktopPushSubscriptionCommand: {
+            content: {
+                "application/json": components["schemas"]["UnregisterDesktopPushSubscriptionCommand"];
+            };
+        };
         CreateInboxCustomerCommand: {
             content: {
                 "application/json": components["schemas"]["CreateInboxCustomerCommand"];
@@ -3254,6 +3441,34 @@ export interface operations {
             503: components["responses"]["ServiceUnavailable"];
         };
     };
+    getDesktopNotificationSettings: {
+        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 desktop-notification settings for the selected rooftop. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DesktopNotificationSettingsResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
     createInboxCustomer: {
         parameters: {
             query?: never;
@@ -3641,6 +3856,69 @@ export interface operations {
             503: components["responses"]["ServiceUnavailable"];
         };
     };
+    setDesktopNotificationPreference: {
+        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"]["SetDesktopNotificationPreferenceCommand"];
+        responses: {
+            200: components["responses"]["DesktopNotificationPreferenceApplied"];
+            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;
+            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"]["RegisterDesktopPushSubscriptionCommand"];
+        responses: {
+            200: components["responses"]["DesktopPushSubscriptionRegistered"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    unregisterDesktopPushSubscription: {
+        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"]["UnregisterDesktopPushSubscriptionCommand"];
+        responses: {
+            200: components["responses"]["DesktopPushSubscriptionUnregistered"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
     resolveInboxMentions: {
         parameters: {
             query?: never;