@opencx/mcp 1.11.87 → 1.11.88

package/dist/schema.d.ts

@@ -1432,6 +1432,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/impact-report/sankey/tickets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the tickets behind a Sankey node/link
+         * @description Drill down into a conversation-flow Sankey: list the actual chat sessions (tickets) that flow through a clicked node or link. Pass the SAME dimensions/date/custom_data_key as getConversationSankey, plus a JSON-encoded `path` — one {layerIndex, bucket} constraint for a clicked node, two for a clicked link. Paginated via limit/offset. Chain into investigate_session on a returned ticket id to diagnose the "why".
+         */
+        get: operations["getConversationSankeyTickets"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/impact-report/sankey/dimensions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List conversation-flow Sankey dimensions
+         * @description List the dimension keys a conversation-flow Sankey can be sliced by, plus the org's observed custom-data keys (with labels) for contact_custom_data and session_custom_data. Call this before getConversationSankey to choose valid dimensions and the custom_data_key.
+         */
+        get: operations["getConversationSankeyDimensions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/office-hours": {
         parameters: {
             query?: never;
@@ -5874,7 +5914,7 @@ export interface components {
             nodes: {
                 id: string;
                 /** @enum {string} */
-                dimensionKey: "all_tickets" | "replied_by" | "outcome" | "handoff" | "channel" | "integration_source" | "assist_mode" | "contact_custom_data" | "session_custom_data" | "sentiment" | "status" | "assigned_team" | "contact_source";
+                dimensionKey: "all_tickets" | "replied_by" | "outcome" | "handoff" | "channel" | "integration_source" | "assist_mode" | "contact_custom_data" | "session_custom_data" | "sentiment" | "status" | "assigned_team" | "contact_source" | "csat" | "handoff_reason" | "contact_reason";
                 dimensionLabel: string;
                 bucket: string;
                 count: number;
@@ -5885,6 +5925,32 @@ export interface components {
                 value: number;
             }[];
         };
+        SankeyTicketsResDto: {
+            tickets: {
+                /** Format: uuid */
+                id: string;
+                ticketNumber: number;
+                channel: string;
+                aiClosureType: string | null;
+                mainStatus: string;
+                sentiment: string | null;
+                createdAt: string;
+                lastMessage: string | null;
+                contactName: string | null;
+                contactEmail: string | null;
+            }[];
+            total: number;
+            hasMore: boolean;
+        };
+        SankeyDimensionCatalogResDto: {
+            dimensions: {
+                /** @enum {string} */
+                key: "all_tickets" | "replied_by" | "outcome" | "handoff" | "channel" | "integration_source" | "assist_mode" | "contact_custom_data" | "session_custom_data" | "sentiment" | "status" | "assigned_team" | "contact_source" | "csat" | "handoff_reason" | "contact_reason";
+                label: string;
+                requiresCustomDataKey: boolean;
+                customDataKeys?: string[];
+            }[];
+        };
         EmailTemplateActivityItemDto: {
             id: string;
             from_email: string;
@@ -11044,9 +11110,9 @@ export interface operations {
     getConversationSankey: {
         parameters: {
             query: {
-                /** @description Comma-separated dimension keys, e.g. "replied_by,outcome". 1–6 allowed. */
+                /** @description Ordered dimensions, 1–6, built left→right. Either a comma-separated key list ("replied_by,outcome") or a JSON array of {dimension, customDataKey} to give each custom-data column its own jsonb key, e.g. [{"dimension":"contact_custom_data","customDataKey":"tier"},{"dimension":"session_custom_data","customDataKey":"plan"}]. */
                 dimensions: string;
-                /** @description The jsonb key to read for a custom-data dimension (contact_custom_data or session_custom_data). */
+                /** @description Fallback jsonb key for custom-data dimensions given via the CSV form (or when a JSON dimension omits its own customDataKey). Ignored where a dimension carries its own key. */
                 custom_data_key?: string;
                 /** @description Start date in ISO 8601 format (defaults to 30 days ago) */
                 start_date?: string;
@@ -11079,6 +11145,77 @@ export interface operations {
             };
         };
     };
+    getConversationSankeyTickets: {
+        parameters: {
+            query: {
+                /** @description Ordered dimensions, 1–6, built left→right. Either a comma-separated key list ("replied_by,outcome") or a JSON array of {dimension, customDataKey} to give each custom-data column its own jsonb key, e.g. [{"dimension":"contact_custom_data","customDataKey":"tier"},{"dimension":"session_custom_data","customDataKey":"plan"}]. */
+                dimensions: string;
+                /** @description JSON-encoded array of {layerIndex, bucket} constraints identifying the clicked target: 1 constraint = a clicked node, 2 = a clicked link. bucket may be an "Other (N)" label. */
+                path: string;
+                /** @description Fallback jsonb key for custom-data dimensions given via the CSV form (or when a JSON dimension omits its own customDataKey). Ignored where a dimension carries its own key. */
+                custom_data_key?: string;
+                /** @description Start date in ISO 8601 format (defaults to 30 days ago) */
+                start_date?: string;
+                /** @description End date in ISO 8601 format (defaults to now) */
+                end_date?: string;
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SankeyTicketsResDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    getConversationSankeyDimensions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SankeyDimensionCatalogResDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     listOfficeHours: {
         parameters: {
             query?: never;