@pam-ai/pam-ordo-contracts 3.49.0 → 3.51.0

package/dist/generated.d.ts

@@ -1241,7 +1241,7 @@ export interface components {
         };
         /** @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. */
+        /** @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. A notification frame may carry the recipient's unread total after the change (unreadCount), the version that total was read at (unreadVersion), and what kind of change it was (notificationChange), so the badge and tab title can move without a request. They are hints; the notification list stays authoritative. */
         RealtimeInvalidationV1: {
             /** @constant */
             schemaVersion: 1;
@@ -1253,6 +1253,15 @@ export interface components {
             areas: components["schemas"]["RealtimeQueryAreaV1"][];
             /** Format: uuid */
             conversationId?: string;
+            /** @description Recipient's visible unread notification total after this change, as NotificationListResponse.unreadCount would report it. Only present when areas includes notifications. Older clients ignore it. */
+            unreadCount?: number;
+            /** @description The recipient's notification state version unreadCount was read at. It only grows. Frames can arrive out of order, so a client keeps the count with the highest version it has seen, from frames and from NotificationListResponse.meta.unreadVersion alike, and ignores an older one. A snoozed notification waking changes the count without a new version, so two counts at one version can disagree; neither is known to be newer, and a client re-reads the list. */
+            unreadVersion?: number;
+            /**
+             * @description What changed for the recipient. created means at least one new notification row exists, which a client cannot tell from the total alone (a read and a new notification together leave it unchanged). Only present when areas includes notifications.
+             * @enum {string}
+             */
+            notificationChange?: "created" | "read" | "dismissed" | "snoozed";
             aggregate?: {
                 /** @enum {string} */
                 type: "conversation" | "work_cycle" | "attention_cycle" | "notification" | "customer_note";
@@ -1710,6 +1719,36 @@ export interface components {
             medianMinutes: number | null;
             sampleCount: number;
         };
+        /** @description Customer-facing outbound events sent by a human user in [from,to), attributed to the actual sender. Excludes Pam, system, internal and producer-marked automated interactions. Voicemail is separate and must not be added to calls without an explicit display definition. Counts use the existing Team scope. */
+        ReportingHumanOutboundByKind: {
+            call: number;
+            sms: number;
+            voicemail: number;
+        };
+        ReportingHistoryOwner: {
+            userId: string;
+            distinctConversationsHeld: number;
+        };
+        /** @description Earliest persisted overlapping assignment in the authorized population is observation evidence, never a completeness watermark. Current storage cannot certify historical ingestion or historical roster membership. */
+        ReportingHistoryCoverage: {
+            /** @enum {string} */
+            status: "unverified";
+            earliestAssignmentAt: string | null;
+            /** @enum {string} */
+            reason: "historical_coverage_unverified";
+        };
+        /** @description Distinct Conversations with a positive-duration assignment interval intersecting [from,to) and its WorkCycle lifetime. Owners are intersected with the current authorized roster (not a reconstructed historical roster). Unassigned work is excluded. Team total deduplicates across owners and WorkCycles; owner totals deduplicate within each owner, so their sum can exceed the team total. Counts describe persisted evidence only. Consumers must not present an exact historical total when complete is false. No current-owner proxy is used. */
+        ReportingHistory: {
+            distinctConversationsHeld: number;
+            byOwner: components["schemas"]["ReportingHistoryOwner"][];
+            /** @enum {string} */
+            definitionVersion: "assignment-overlap-current-roster-v1";
+            /** @enum {boolean} */
+            complete: false;
+            coverage: components["schemas"]["ReportingHistoryCoverage"];
+            /** @description False when the 500-owner response bound omitted owner rows; the team total is not truncated. */
+            ownersComplete?: boolean;
+        };
         /** @description One person's line in the Reporting table. Listed when they own open work in scope now, or sent customer-facing outbound in the window. Queue fields are right now; outbound and reply are the window's. */
         ReportingOwnerRollup: {
             userId: string;
@@ -1721,12 +1760,14 @@ export interface components {
             /** @description Customer-facing outbound this person sent in the window. */
             outbound: number;
             reply: components["schemas"]["ReportingReplyStats"];
+            humanOutboundByKind?: components["schemas"]["ReportingHumanOutboundByKind"];
         };
         /** @description Customer-facing outbound in the window - calls and texts, never internal notes or system interactions - and reply time across everyone who answered. */
         ReportingMessageMetrics: {
             outbound: number;
             outboundByPam: number;
             reply: components["schemas"]["ReportingReplyStats"];
+            humanOutboundByKind?: components["schemas"]["ReportingHumanOutboundByKind"];
         };
         ReportingSummary: {
             clientOrgId: string;
@@ -1739,6 +1780,11 @@ export interface components {
             live?: components["schemas"]["ReportingQueueCounts"];
             owners?: components["schemas"]["ReportingOwnerRollup"][];
             messages?: components["schemas"]["ReportingMessageMetrics"];
+            history?: components["schemas"]["ReportingHistory"];
+            /** @description Requested sections whose source query failed. They are omitted, never zero-filled; independently successful sections remain available. */
+            unavailableSections?: ("LIVE" | "OWNERS" | "MESSAGES" | "HISTORY")[];
+            /** @description False when the 500-owner response bound omitted owner rows. Missing on older producers; do not assume completeness. */
+            ownersComplete?: boolean;
         };
         ReportingSummaryResponse: {
             data: components["schemas"]["ReportingSummary"];
@@ -2161,6 +2207,8 @@ export interface components {
             meta: {
                 /** @description Opaque keyset cursor. */
                 nextCursor: string | null;
+                /** @description The recipient's notification state version unreadCount was read at; the same clock as RealtimeInvalidationV1.unreadVersion. */
+                unreadVersion?: number;
             };
         };
         BulkHydrationReferenceV1: {
@@ -3699,8 +3747,8 @@ export interface operations {
                 teamId?: components["parameters"]["ReportingTeamId"];
                 /** @description Same meaning as departments on GET /v1/inbox/conversations with scope TEAM_INBOX, including the attribution of unassigned work to BDC. A service manager's page sends SERVICE. */
                 departments?: components["parameters"]["ReportingDepartments"];
-                /** @description Sections to compute. Absent computes all three. */
-                include?: ("LIVE" | "OWNERS" | "MESSAGES")[];
+                /** @description Sections to compute. Absent computes LIVE, OWNERS and MESSAGES. HISTORY is opt-in. */
+                include?: ("LIVE" | "OWNERS" | "MESSAGES" | "HISTORY")[];
             };
             header: {
                 /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
@@ -4119,6 +4167,8 @@ export interface operations {
             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"];
+                /** @description The ETag of a page this client already holds. When nothing that page depends on can have changed, the response is 304 with no body. */
+                "If-None-Match"?: string;
             };
             path?: never;
             cookie?: never;
@@ -4129,12 +4179,26 @@ export interface operations {
             200: {
                 headers: {
                     "x-correlation-id": components["headers"]["CorrelationId"];
+                    /** @description Weak validator for this page, scoped to the viewer, rooftop, cursor, and limit. Opaque; clients must not parse it. */
+                    ETag?: string;
+                    /** @description Private to the viewer and revalidated on every use. */
+                    "Cache-Control"?: "private, no-cache";
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": components["schemas"]["NotificationListResponse"];
                 };
             };
+            /** @description The page named by If-None-Match is still current. No body; reuse the held page. */
+            304: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    /** @description The same validator the request sent. */
+                    ETag?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             400: components["responses"]["BadRequest"];
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];