@pam-ai/pam-ordo-contracts 3.40.0 → 3.41.0

package/dist/generated.d.ts

@@ -59,6 +59,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inbox/reporting/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Team reporting figures for one window
+         * @description The Reporting page's figures, computed by the service rather than counted off listed rows. Scope is TEAM_INBOX exactly - the same visibility, the same teamId and departments semantics - so a tile can drill into the TEAM_INBOX list it counts and the two agree. live is the queue right now and ignores the window; owners and messages are bounded by the window. include names the sections to compute, so a comparison read of the previous window can ask for messages alone.
+         */
+        get: operations["getInboxReportingSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/reporting/count-snapshots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The live queue counts as they stood at an earlier moment
+         * @description Open, overdue and needs-attention counts from the hourly snapshot taken at or before at, no earlier than two hours before it, summed over the same scope /v1/inbox/reporting/summary uses today. Snapshots are kept per owner, so the scope is applied to the people in it now: the comparison is the same people then and now. data is null when no snapshot falls inside that tolerance - before the first capture, after the 31-day retention, or across a missed hour - and a client then shows no comparison rather than a wrong one.
+         */
+        get: operations["getInboxReportingCountSnapshot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inbox/realtime-session": {
         parameters: {
             query?: never;
@@ -1498,6 +1538,59 @@ export interface components {
              */
             latestUnrespondedInboundPreview?: string | null;
         };
+        /** @description The three queue counts the Reporting page shows, with the same meaning as the matching InboxCounts fields for TEAM_INBOX in the same scope. */
+        ReportingQueueCounts: {
+            open: number;
+            overdue: number;
+            needsAttention: number;
+        };
+        /** @description Time to a first reply. The first unanswered customer inbound in a Conversation starts the clock and the next customer-facing outbound stops it; the gap is credited to whoever sent that outbound, Pam included. A gap counts in the window its outbound falls in. Gaps over 720 minutes are not replies and are left out. Mean and median travel together because the gap between them is the finding. */
+        ReportingReplyStats: {
+            meanMinutes: number | null;
+            medianMinutes: number | null;
+            sampleCount: number;
+        };
+        /** @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;
+            open: number;
+            overdue: number;
+            needsAttention: number;
+            /** @description The longest-waiting unanswered inbound across their open work, or null. */
+            oldestUnrespondedAt: string | null;
+            /** @description Customer-facing outbound this person sent in the window. */
+            outbound: number;
+            reply: components["schemas"]["ReportingReplyStats"];
+        };
+        /** @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"];
+        };
+        ReportingSummary: {
+            clientOrgId: string;
+            /** Format: date-time */
+            observedAt: string;
+            /** Format: date-time */
+            from: string;
+            /** Format: date-time */
+            to: string;
+            live?: components["schemas"]["ReportingQueueCounts"];
+            owners?: components["schemas"]["ReportingOwnerRollup"][];
+            messages?: components["schemas"]["ReportingMessageMetrics"];
+        };
+        ReportingSummaryResponse: {
+            data: components["schemas"]["ReportingSummary"];
+        };
+        ReportingCountSnapshot: {
+            /** Format: date-time */
+            capturedAt: string;
+            counts: components["schemas"]["ReportingQueueCounts"];
+        };
+        ReportingCountSnapshotResponse: {
+            data: components["schemas"]["ReportingCountSnapshot"] | null;
+        };
         InboxCounts: {
             total: number;
             open: number;
@@ -3069,6 +3162,14 @@ export interface components {
         ConversationId: string;
         InteractionId: string;
         AttachmentId: string;
+        /** @description Window start, inclusive. */
+        ReportingFrom: string;
+        /** @description Window end, exclusive. Must be after from. */
+        ReportingTo: string;
+        /** @description Same meaning as teamId on GET /v1/inbox/conversations - the caller's own Team, never another. */
+        ReportingTeamId: string;
+        /** @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. */
+        ReportingDepartments: ("SERVICE" | "BDC")[];
         StaffUserId: string;
     };
     requestBodies: {
@@ -3358,6 +3459,79 @@ export interface operations {
             503: components["responses"]["ServiceUnavailable"];
         };
     };
+    getInboxReportingSummary: {
+        parameters: {
+            query: {
+                /** @description Window start, inclusive. */
+                from: components["parameters"]["ReportingFrom"];
+                /** @description Window end, exclusive. Must be after from. */
+                to: components["parameters"]["ReportingTo"];
+                /** @description Same meaning as teamId on GET /v1/inbox/conversations - the caller's own Team, never another. */
+                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")[];
+            };
+            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 The requested sections for the window. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReportingSummaryResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    getInboxReportingCountSnapshot: {
+        parameters: {
+            query: {
+                at: string;
+                /** @description Same meaning as teamId on GET /v1/inbox/conversations - the caller's own Team, never another. */
+                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"];
+            };
+            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 The snapshot nearest at, or null. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReportingCountSnapshotResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
     createInboxRealtimeSession: {
         parameters: {
             query?: never;