@opencx/mcp 1.15.9 → 1.15.11

package/dist/partner-analytics.spec.d.ts

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

package/dist/partner-analytics.spec.d.ts.map

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

package/dist/partner-analytics.spec.js

@@ -0,0 +1,208 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { connectInMemory, fetchCallHeaders, fetchCallUrl, toolTextResultSchema, } from './spec-helpers.js';
+// The three partner-wide tools: they wrap the partner-analytics public API 1:1
+// (same key, same envelope as run_analytics_query), and — like their org
+// sibling — surface API 4xx (a 403 for a non-partner-admin org, a 400 for bad
+// SQL) as a normal `{ ok: false }` result the model can read and act on, never
+// as a thrown tool error.
+function mockResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+function requestMethod(call) {
+    const [input, init] = call;
+    if (input instanceof Request)
+        return input.method;
+    return init?.method ?? 'GET';
+}
+async function requestBody(call) {
+    const [input, init] = call;
+    if (input instanceof Request) {
+        const text = await input.clone().text();
+        return text ? JSON.parse(text) : undefined;
+    }
+    return typeof init?.body === 'string' ? JSON.parse(init.body) : undefined;
+}
+describe('partner analytics tools', () => {
+    let client;
+    let cleanup;
+    let fetchSpy;
+    beforeEach(async () => {
+        fetchSpy = vi.fn();
+        vi.stubGlobal('fetch', fetchSpy);
+        ({ client, cleanup } = await connectInMemory());
+    });
+    afterEach(async () => {
+        await cleanup();
+        vi.restoreAllMocks();
+    });
+    it('registers list_partner_orgs, search_partner_orgs and run_partner_analytics_query, all flagged partner-admin-only', async () => {
+        const { tools } = await client.listTools();
+        const byName = new Map(tools.map((t) => [t.name, t]));
+        for (const name of [
+            'list_partner_orgs',
+            'search_partner_orgs',
+            'run_partner_analytics_query',
+        ]) {
+            const tool = byName.get(name);
+            expect(tool, name).toBeDefined();
+            expect(tool?.description, name).toMatch(/PARTNER ADMIN ORGS ONLY/);
+        }
+        // The roster tool points at the search tool for finding/ranking customers;
+        // the search tool documents the health statuses the model will be asked about.
+        expect(byName.get('list_partner_orgs')?.description).toContain('search_partner_orgs');
+        for (const status of ['new', 'setup_incomplete', 'inactive', 'healthy']) {
+            expect(byName.get('search_partner_orgs')?.description).toContain(status);
+        }
+        // The partner tool names its views and how to name orgs; the org tool is unchanged.
+        expect(byName.get('run_partner_analytics_query')?.description).toContain('report_partner_sessions');
+        expect(byName.get('run_partner_analytics_query')?.description).toContain('org_id');
+        expect(byName.get('run_analytics_query')?.description).not.toContain('report_partner_');
+    });
+    it('list_partner_orgs GETs /partner-analytics/orgs with the API key and returns the roster', async () => {
+        const roster = {
+            partner: { id: 'p1', name: 'FareHarbor' },
+            data: [{ id: 'o1', name: 'Alpha Boats', external_id: 'alpha', tags: ['rank-1'] }],
+            total: 1,
+        };
+        fetchSpy.mockResolvedValueOnce(mockResponse(roster));
+        const result = toolTextResultSchema.parse(await client.callTool({ name: 'list_partner_orgs', arguments: {} }));
+        const call = fetchSpy.mock.calls[0];
+        expect(fetchCallUrl(call)).toBe('https://api.test.com/partner-analytics/orgs');
+        expect(requestMethod(call)).toBe('GET');
+        expect(fetchCallHeaders(call).get('authorization')).toBe('Bearer test-api-key');
+        expect(result.isError).toBeFalsy();
+        expect(JSON.parse(result.content[0].text)).toEqual(roster);
+    });
+    it('search_partner_orgs GETs /partner-analytics/orgs/search with every filter as a query param', async () => {
+        const page = {
+            partner: { id: 'p1', name: 'FareHarbor' },
+            data: [
+                {
+                    id: 'o1',
+                    name: 'Alpha Boats',
+                    external_id: 'alpha',
+                    tags: ['rank-1'],
+                    health: { status: 'inactive', sessions_30d: 0, total_sessions: 12 },
+                    channels: { chat: true, email: false, whatsapp: false, voice: false },
+                },
+            ],
+            total: 1,
+            limit: 25,
+            offset: 50,
+        };
+        fetchSpy.mockResolvedValueOnce(mockResponse(page));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'search_partner_orgs',
+            arguments: {
+                q: 'alpha',
+                status: 'inactive,new',
+                has_ai: 'true',
+                has_actions: 'false',
+                tags: 'rank-1,rank-2',
+                channels: 'chat',
+                sort_by: 'sessions_30d',
+                sort_dir: 'desc',
+                limit: 25,
+                offset: 50,
+            },
+        }));
+        const call = fetchSpy.mock.calls[0];
+        const url = new URL(fetchCallUrl(call));
+        expect(url.origin + url.pathname).toBe('https://api.test.com/partner-analytics/orgs/search');
+        expect(Object.fromEntries(url.searchParams)).toEqual({
+            q: 'alpha',
+            status: 'inactive,new',
+            has_ai: 'true',
+            has_actions: 'false',
+            tags: 'rank-1,rank-2',
+            channels: 'chat',
+            sort_by: 'sessions_30d',
+            sort_dir: 'desc',
+            limit: '25',
+            offset: '50',
+        });
+        expect(requestMethod(call)).toBe('GET');
+        expect(fetchCallHeaders(call).get('authorization')).toBe('Bearer test-api-key');
+        expect(result.isError).toBeFalsy();
+        expect(JSON.parse(result.content[0].text)).toEqual(page);
+    });
+    it('search_partner_orgs with no arguments sends no query params (server defaults apply)', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ partner: { id: 'p1', name: 'P' }, data: [], total: 0, limit: 50, offset: 0 }));
+        await client.callTool({ name: 'search_partner_orgs', arguments: {} });
+        const call = fetchSpy.mock.calls[0];
+        expect(fetchCallUrl(call)).toBe('https://api.test.com/partner-analytics/orgs/search');
+    });
+    it('search_partner_orgs surfaces a 403 (not a partner admin org) as { ok: false }', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ message: 'This organization does not administer a partner.' }, 403));
+        const result = toolTextResultSchema.parse(await client.callTool({ name: 'search_partner_orgs', arguments: { q: 'x' } }));
+        expect(result.isError).toBeFalsy();
+        expect(JSON.parse(result.content[0].text)).toMatchObject({ ok: false, status: 403 });
+    });
+    it('run_partner_analytics_query POSTs sql + parameters to /partner-analytics/query', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ rows: [{ org_id: 'o1', n: '3' }], row_count: 1, truncated: false }));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'run_partner_analytics_query',
+            arguments: {
+                sql: 'SELECT org_id, count() AS n FROM report_partner_sessions WHERE channel = ? GROUP BY org_id',
+                parameters: ['web'],
+            },
+        }));
+        const call = fetchSpy.mock.calls[0];
+        expect(fetchCallUrl(call)).toBe('https://api.test.com/partner-analytics/query');
+        expect(requestMethod(call)).toBe('POST');
+        expect(await requestBody(call)).toEqual({
+            sql: 'SELECT org_id, count() AS n FROM report_partner_sessions WHERE channel = ? GROUP BY org_id',
+            parameters: ['web'],
+        });
+        expect(result.isError).toBeFalsy();
+        expect(JSON.parse(result.content[0].text)).toEqual({
+            rows: [{ org_id: 'o1', n: '3' }],
+            row_count: 1,
+            truncated: false,
+        });
+    });
+    it('defaults parameters to [] when omitted', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ rows: [], row_count: 0, truncated: false }));
+        await client.callTool({
+            name: 'run_partner_analytics_query',
+            arguments: { sql: 'SELECT count() FROM report_partner_sessions' },
+        });
+        expect(await requestBody(fetchSpy.mock.calls[0])).toEqual({
+            sql: 'SELECT count() FROM report_partner_sessions',
+            parameters: [],
+        });
+    });
+    it('surfaces a 403 (not a partner admin org) as a readable { ok: false } result, not a tool error', async () => {
+        const forbidden = {
+            statusCode: 403,
+            message: 'Partner analytics are only available to partner admin organizations.',
+        };
+        fetchSpy.mockResolvedValueOnce(mockResponse(forbidden, 403));
+        const result = toolTextResultSchema.parse(await client.callTool({ name: 'list_partner_orgs', arguments: {} }));
+        expect(result.isError).toBeFalsy();
+        // `error` is the raw response body (same shape run_analytics_query returns).
+        expect(JSON.parse(result.content[0].text)).toEqual({
+            ok: false,
+            status: 403,
+            error: JSON.stringify(forbidden),
+        });
+    });
+    it('surfaces a 400 (bad SQL) as { ok: false } so the model can correct and retry', async () => {
+        const bad = { statusCode: 400, message: 'Query failed (47): Unknown expression identifier' };
+        fetchSpy.mockResolvedValueOnce(mockResponse(bad, 400));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'run_partner_analytics_query',
+            arguments: { sql: 'SELECT nope FROM report_partner_sessions' },
+        }));
+        expect(result.isError).toBeFalsy();
+        expect(JSON.parse(result.content[0].text)).toEqual({
+            ok: false,
+            status: 400,
+            error: JSON.stringify(bad),
+        });
+    });
+});
+//# sourceMappingURL=partner-analytics.spec.js.map

package/dist/partner-analytics.spec.js.map

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

package/dist/schema.d.ts

@@ -4048,6 +4048,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/partner-analytics/orgs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the connected orgs of the calling partner admin org
+         * @description The partner's connected organizations — the scope of every `runPartnerAnalyticsQuery` and the org dimension (id → name) to join `report_partner_*` rows to. Only available to partner admin organizations (403 otherwise).
+         */
+        get: operations["listPartnerOrgs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/partner-analytics/orgs/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Search connected orgs with health signals (paginated)
+         * @description Find, filter, sort and page through the calling partner's connected orgs (its customers), each with the health signals the Partner Admin console shows: `health.status` — `new` (connected < 7 days, no sessions yet), `setup_incomplete` (no knowledge sources and no actions), `inactive` (no session in the last 30 days), `healthy` (everything else) — plus `members`, `data_sources`, `has_ai_training`, `has_actions`, `sessions_30d`, `total_sessions`, `last_session_at`, and per-channel connected flags (`chat`, `email`, `whatsapp`, `voice`). `q` matches name or external_id; `status`, `tags` and `channels` are comma-separated (tags match ANY, channels match ALL); `has_ai` / `has_actions` are 'true' / 'false'. Max 100 rows per page (`limit`/`offset`); `total` is the filtered count. For volume, quality and behaviour beyond these signals use `runPartnerAnalyticsQuery`; for the full id → name roster use `listPartnerOrgs`. Only available to partner admin organizations (403 otherwise).
+         */
+        get: operations["searchPartnerOrgs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/partner-analytics/query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Run a read-only analytics query across the partner’s connected orgs
+         * @description Run a read-only SQL query against the partner-scoped `report_partner_*` analytics views (the same columns as the org `report_*` views, plus `org_id`), covering every org connected to the calling partner admin org. Read-only and scoped server-side; only available to partner admin organizations (403 otherwise).
+         */
+        post: operations["runPartnerAnalyticsQuery"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/salesforce/miaw/webhook": {
         parameters: {
             query?: never;
@@ -8719,6 +8779,57 @@ export interface components {
             row_count: number;
             truncated: boolean;
         };
+        PartnerOrgDto: {
+            id: string;
+            name: string;
+            external_id: string | null;
+            tags: string[];
+            created_at: string | null;
+        };
+        ListPartnerOrgsResponseDto: {
+            partner: {
+                id: string;
+                name: string;
+            };
+            data: components["schemas"]["PartnerOrgDto"][];
+            total: number;
+        };
+        PartnerOrgHealthDto: {
+            id: string;
+            name: string;
+            external_id: string | null;
+            website: string | null;
+            logo_url: string | null;
+            created_at: string | null;
+            tags: string[];
+            health: {
+                /** @enum {string} */
+                status: "healthy" | "setup_incomplete" | "inactive" | "new";
+                members: number;
+                data_sources: number;
+                has_ai_training: boolean;
+                has_actions: boolean;
+                sessions_30d: number;
+                total_sessions: number;
+                last_session_at: string | null;
+            };
+            channels: {
+                chat: boolean;
+                email: boolean;
+                whatsapp: boolean;
+                voice: boolean;
+            };
+        };
+        SearchPartnerOrgsResponseDto: {
+            partner: {
+                id: string;
+                name: string;
+            };
+            data: components["schemas"]["PartnerOrgHealthDto"][];
+            total: number;
+            limit: number;
+            offset: number;
+        };
         OfficeHoursPublicResponseDto: {
             /** @description Office hours schedule ID */
             id: string;
@@ -17386,6 +17497,108 @@ export interface operations {
             };
         };
     };
+    listPartnerOrgs: {
+        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"]["ListPartnerOrgsResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    searchPartnerOrgs: {
+        parameters: {
+            query?: {
+                limit?: number;
+                offset?: number;
+                q?: string;
+                status?: string;
+                has_ai?: "true" | "false";
+                has_actions?: "true" | "false";
+                tags?: string;
+                channels?: string;
+                sort_by?: "created_at" | "name" | "members" | "data_sources" | "sessions_30d" | "total_sessions" | "last_session_at";
+                sort_dir?: "asc" | "desc";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchPartnerOrgsResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    runPartnerAnalyticsQuery: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RunReportQueryBody"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RunReportQueryResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     getSalesforceCrmConnectionStatus: {
         parameters: {
             query?: never;