@opencx/mcp 1.11.81 → 1.11.83

package/dist/filter-sessions-dates.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter-sessions-dates.spec.d.ts.map

package/dist/filter-sessions-dates.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-sessions-dates.spec.d.ts","sourceRoot":"","sources":["../src/filter-sessions-dates.spec.ts"],"names":[],"mappings":""}

package/dist/filter-sessions-dates.spec.js

@@ -0,0 +1,89 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { z } from 'zod';
+import { createServer } from './server.js';
+// Prod agents kept sending date-only strings ("2026-06-01") to
+// `filter_sessions`, which the backend rejects with 400 "Invalid ISO
+// datetime" on `filters.date.from/to`. The schema now validates full ISO
+// datetimes at the MCP layer so the failure is immediate and names the
+// expected format instead of surfacing as an opaque API 400.
+describe('filter_sessions date validation', () => {
+    let client;
+    let cleanup;
+    let fetchSpy;
+    beforeEach(async () => {
+        fetchSpy = vi.fn();
+        vi.stubGlobal('fetch', fetchSpy);
+        const server = createServer('test-api-key', 'https://api.test.com');
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await server.connect(serverTransport);
+        client = new Client({ name: 'test-client', version: '1.0.0' });
+        await client.connect(clientTransport);
+        cleanup = async () => {
+            await client.close();
+            await server.close();
+        };
+    });
+    afterEach(async () => {
+        await cleanup();
+        vi.unstubAllGlobals();
+    });
+    it('rejects date-only strings before any API call', async () => {
+        const result = await client.callTool({
+            name: 'filter_sessions',
+            arguments: { date_from: '2026-06-01', date_to: '2026-06-08' },
+        });
+        expect(result.isError).toBe(true);
+        const text = JSON.stringify(result.content);
+        expect(text).toContain('Invalid datetime');
+        expect(text).toContain('date_from');
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    // The backend DTO validates with bare `.datetime()` (UTC `Z` only), so the
+    // MCP schema must reject offsets too — `{ offset: true }` here would pass
+    // values the backend still 400s on.
+    it('rejects timezone-offset datetimes the backend would 400 on', async () => {
+        const result = await client.callTool({
+            name: 'filter_sessions',
+            arguments: { date_from: '2026-06-01T00:00:00+02:00' },
+        });
+        expect(result.isError).toBe(true);
+        expect(JSON.stringify(result.content)).toContain('Invalid datetime');
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('still works with no dates at all (most common call)', async () => {
+        fetchSpy.mockResolvedValue(new Response(JSON.stringify({ items: [], total: 0 }), { status: 200, statusText: 'OK' }));
+        const result = await client.callTool({ name: 'filter_sessions', arguments: {} });
+        expect(result.isError).toBeFalsy();
+        expect(fetchSpy).toHaveBeenCalledTimes(1);
+        const arg = fetchSpy.mock.calls[0]?.[0];
+        if (!(arg instanceof Request))
+            throw new Error('expected fetch to receive a Request');
+        const body = z
+            .object({ filters: z.object({ date: z.unknown().optional() }) })
+            .parse(JSON.parse(await arg.clone().text()));
+        expect(body.filters.date).toBeUndefined();
+    });
+    it('accepts full ISO 8601 datetimes and forwards them as the date filter', async () => {
+        fetchSpy.mockResolvedValue(new Response(JSON.stringify({ items: [], total: 0 }), { status: 200, statusText: 'OK' }));
+        const result = await client.callTool({
+            name: 'filter_sessions',
+            arguments: { date_from: '2026-06-01T00:00:00Z', date_to: '2026-06-08T23:59:59Z' },
+        });
+        expect(result.isError).toBeFalsy();
+        expect(fetchSpy).toHaveBeenCalledTimes(1);
+        // openapi-fetch always passes a fully-built Request as the first arg.
+        const arg = fetchSpy.mock.calls[0]?.[0];
+        if (!(arg instanceof Request))
+            throw new Error('expected fetch to receive a Request');
+        const body = z
+            .object({ filters: z.object({ date: z.object({ from: z.string(), to: z.string() }) }) })
+            .parse(JSON.parse(await arg.clone().text()));
+        expect(body.filters.date).toEqual({
+            from: '2026-06-01T00:00:00Z',
+            to: '2026-06-08T23:59:59Z',
+        });
+    });
+});
+//# sourceMappingURL=filter-sessions-dates.spec.js.map

package/dist/filter-sessions-dates.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-sessions-dates.spec.js","sourceRoot":"","sources":["../src/filter-sessions-dates.spec.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -1240,6 +1240,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/handoff-analytics/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List handoff events
+         * @description Returns a paginated list of individual AI-to-human handoff events, newest first. Each event includes the AI-written summary and explanation of why it handed off, the handoff reasons, sentiment, and the session ID. Filter by reason (e.g. insufficient_tools) and date range to analyze recurring gaps.
+         */
+        get: operations["listHandoffEvents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/handoff-analytics": {
         parameters: {
             query?: never;
@@ -6965,7 +6985,7 @@ export interface components {
             /** Format: email */
             email: string;
             avatar_url?: string | null;
-            permissions?: ("*" | "sessions:read" | "sessions:write" | "sessions-shared-views:read" | "sessions-shared-views:write" | "contacts:read" | "contacts:write" | "sequences:read" | "sequences:write" | "ai-training:read" | "ai-training:write" | "reports:read" | "reports:write" | "help-center:read" | "help-center:write" | "workflows:read" | "workflows:write" | "actions:read" | "actions:write" | "settings:read" | "settings:write" | "settings-channels:read" | "settings-channels:write" | "settings-helpdesk:read" | "settings-helpdesk:write" | "settings-groups:read" | "settings-groups:write" | "settings-roles:read" | "settings-roles:write" | "settings-macros:read" | "settings-macros:write")[] | null;
+            permissions?: ("*" | "sessions:read" | "sessions:write" | "sessions-shared-views:read" | "sessions-shared-views:write" | "contacts:read" | "contacts:write" | "sequences:read" | "sequences:write" | "ai-training:read" | "ai-training:write" | "reports:read" | "reports:write" | "help-center:read" | "help-center:write" | "workflows:read" | "workflows:write" | "actions:read" | "actions:write" | "settings:read" | "settings:write" | "settings-channels:read" | "settings-channels:write" | "settings-helpdesk:read" | "settings-helpdesk:write" | "settings-groups:read" | "settings-groups:write" | "settings-roles:read" | "settings-roles:write" | "settings-macros:read" | "settings-macros:write" | "settings-skills:read" | "settings-skills:write")[] | null;
         };
         OrgUserDetail: {
             id: number;
@@ -6974,7 +6994,7 @@ export interface components {
             /** Format: email */
             email: string;
             avatar_url?: string | null;
-            permissions?: ("*" | "sessions:read" | "sessions:write" | "sessions-shared-views:read" | "sessions-shared-views:write" | "contacts:read" | "contacts:write" | "sequences:read" | "sequences:write" | "ai-training:read" | "ai-training:write" | "reports:read" | "reports:write" | "help-center:read" | "help-center:write" | "workflows:read" | "workflows:write" | "actions:read" | "actions:write" | "settings:read" | "settings:write" | "settings-channels:read" | "settings-channels:write" | "settings-helpdesk:read" | "settings-helpdesk:write" | "settings-groups:read" | "settings-groups:write" | "settings-roles:read" | "settings-roles:write" | "settings-macros:read" | "settings-macros:write")[] | null;
+            permissions?: ("*" | "sessions:read" | "sessions:write" | "sessions-shared-views:read" | "sessions-shared-views:write" | "contacts:read" | "contacts:write" | "sequences:read" | "sequences:write" | "ai-training:read" | "ai-training:write" | "reports:read" | "reports:write" | "help-center:read" | "help-center:write" | "workflows:read" | "workflows:write" | "actions:read" | "actions:write" | "settings:read" | "settings:write" | "settings-channels:read" | "settings-channels:write" | "settings-helpdesk:read" | "settings-helpdesk:write" | "settings-groups:read" | "settings-groups:write" | "settings-roles:read" | "settings-roles:write" | "settings-macros:read" | "settings-macros:write" | "settings-skills:read" | "settings-skills:write")[] | null;
             teams: {
                 group: components["schemas"]["GroupDto"];
                 is_user_available_on_group: boolean;
@@ -7402,6 +7422,18 @@ export interface components {
             records: unknown | null;
         }[];
         ListEmailTemplatesOutput: components["schemas"]["EmailTemplateDto"][];
+        ListHandoffEventsOutput: {
+            items: {
+                session_id: string;
+                summary: string;
+                explanation: string | null;
+                reasons: ("based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
+                sentiment: ("angry" | "happy" | "neutral") | null;
+                created_at: string;
+            }[];
+            next: string | null;
+            total: number;
+        };
         ListOfficeHoursOutput: {
             data: components["schemas"]["OfficeHoursPublicResponseDto"][];
         };
@@ -10073,6 +10105,44 @@ export interface operations {
             };
         };
     };
+    listHandoffEvents: {
+        parameters: {
+            query?: {
+                /** @description Pagination cursor from a previous response */
+                cursor?: string;
+                /** @description Only return handoffs that include this reason */
+                reason?: "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance";
+                /** @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;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListHandoffEventsOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     getHandoffAnalytics: {
         parameters: {
             query?: {