@opencx/mcp 1.15.12 → 1.15.13

package/dist/add-session-comment.spec.d.ts

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

package/dist/add-session-comment.spec.d.ts.map

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

package/dist/add-session-comment.spec.js

@@ -0,0 +1,108 @@
+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 { createServer } from './server.js';
+function mockResponse(body, status = 200, statusText = 'OK') {
+    return new Response(JSON.stringify(body), { status, statusText });
+}
+function getRequestUrl(call) {
+    const arg = call[0];
+    if (arg instanceof Request)
+        return arg.url;
+    return String(arg);
+}
+function getRequestMethod(call) {
+    const arg = call[0];
+    if (arg instanceof Request)
+        return arg.method;
+    const opts = call[1];
+    return opts.method ?? 'GET';
+}
+async function getRequestBody(call) {
+    const arg = call[0];
+    if (arg instanceof Request) {
+        const text = await arg.clone().text();
+        return text ? JSON.parse(text) : undefined;
+    }
+    const opts = call[1];
+    return opts.body ? JSON.parse(opts.body) : undefined;
+}
+describe('add_session_comment tool', () => {
+    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('sends thread_id when provided (threaded comment)', async () => {
+        const created = { uuid: 'comment-uuid', comment_thread_id: 'thread-uuid' };
+        fetchSpy.mockResolvedValueOnce(mockResponse(created, 201, 'Created'));
+        await client.callTool({
+            name: 'add_session_comment',
+            arguments: {
+                session_id: 'session-1',
+                thread_id: '4f9df1e2-95d7-4b83-a9be-7d2f0a2f7f11',
+                content: 'threaded note',
+                agent_id: 42,
+            },
+        });
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/chat/sessions/session-1/comments');
+        expect(getRequestMethod(call)).toBe('POST');
+        expect(await getRequestBody(call)).toEqual({
+            thread_id: '4f9df1e2-95d7-4b83-a9be-7d2f0a2f7f11',
+            content: 'threaded note',
+            agent_id: 42,
+        });
+    });
+    it('omits thread_id entirely when not provided (session-level note)', async () => {
+        const created = { uuid: 'comment-uuid', comment_thread_id: null };
+        fetchSpy.mockResolvedValueOnce(mockResponse(created, 201, 'Created'));
+        await client.callTool({
+            name: 'add_session_comment',
+            arguments: {
+                session_id: 'session-1',
+                content: 'session-level note',
+                agent_id: 42,
+            },
+        });
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/chat/sessions/session-1/comments');
+        expect(getRequestMethod(call)).toBe('POST');
+        const body = await getRequestBody(call);
+        expect(body).toEqual({ content: 'session-level note', agent_id: 42 });
+        // The key must be ABSENT, not undefined/null — the public API treats a
+        // missing thread_id as "session-level note".
+        expect(Object.keys(body)).not.toContain('thread_id');
+    });
+    it('rejects a non-uuid thread_id at the tool input layer', async () => {
+        const result = await client.callTool({
+            name: 'add_session_comment',
+            arguments: {
+                session_id: 'session-1',
+                thread_id: 'not-a-uuid',
+                content: 'bad thread',
+                agent_id: 42,
+            },
+        });
+        expect(result.isError).toBe(true);
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=add-session-comment.spec.js.map

package/dist/add-session-comment.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-session-comment.spec.js","sourceRoot":"","sources":["../src/add-session-comment.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,SAAS,YAAY,CAAC,IAAa,EAAE,MAAM,GAAG,GAAG,EAAE,UAAU,GAAG,IAAI;IAClE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,YAAY,OAAO;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAe;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,YAAY,OAAO;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAgB,CAAC;IACpC,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAe;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAgB,CAAC;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,MAAc,CAAC;IACnB,IAAI,OAA4B,CAAC;IACjC,IAAI,QAAkC,CAAC;IAEvC,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACnB,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEjC,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;QACpE,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;QAChF,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAEtC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAEtC,OAAO,GAAG,KAAK,IAAI,EAAE;YACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,OAAO,EAAE,CAAC;QAChB,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;QAC3E,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QAEtE,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE;gBACT,UAAU,EAAE,WAAW;gBACvB,SAAS,EAAE,sCAAsC;gBACjD,OAAO,EAAE,eAAe;gBACxB,QAAQ,EAAE,EAAE;aACb;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QAC1F,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,SAAS,EAAE,sCAAsC;YACjD,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAClE,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QAEtE,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE;gBACT,UAAU,EAAE,WAAW;gBACvB,OAAO,EAAE,oBAAoB;gBAC7B,QAAQ,EAAE,EAAE;aACb;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QAC1F,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,uEAAuE;QACvE,6CAA6C;QAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAA+B,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACnC,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE;gBACT,UAAU,EAAE,WAAW;gBACvB,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,YAAY;gBACrB,QAAQ,EAAE,EAAE;aACb;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/schema.d.ts

@@ -502,7 +502,7 @@ export interface paths {
         put?: never;
         /**
          * Create a session comment
-         * @description Creates an internal human-agent comment on an existing message thread in the chat session.
+         * @description Creates an internal note on the chat session, visible to agents only. Pass thread_id to attach it to a message; omit it for a session-level note.
          */
         post: operations["createChatSessionComment"];
         delete?: never;
@@ -603,7 +603,7 @@ export interface paths {
         put?: never;
         /**
          * Link many contacts to companies
-         * @description Links up to 100 contacts in one call. Failures are isolated: a contact that cannot be linked returns an error in its own result entry and does not affect the others, so the call succeeds even when some links do not. Results come back in request order.
+         * @description Links up to 100 contacts in one call. Name each contact by `contact_id`, `contact_email`, or `contact_phone` — exactly one — so a sync can link straight from the identifiers it already holds. Each result carries the resolved `contact_id`. Failures are isolated: a contact that cannot be linked returns an error in its own result entry and does not affect the others, so the call succeeds even when some links do not. Results come back in request order.
          */
         post: operations["bulkLinkContactsToCompanies"];
         delete?: never;
@@ -5150,6 +5150,34 @@ export interface components {
                 }[];
             })[];
         };
+        UpsertCompanyDto: {
+            external_id: string;
+            name?: string;
+            custom_data?: {
+                [key: string]: string | number | boolean | null;
+            };
+        };
+        BulkLinkContactsDto: {
+            links: {
+                /**
+                 * Format: uuid
+                 * @description The OpenCX contact id, if you already hold it
+                 */
+                contact_id?: string;
+                /**
+                 * Format: email
+                 * @description Look the contact up by email instead of id
+                 */
+                contact_email?: string;
+                /** @description Look the contact up by phone instead of id. `+15551234567` and `15551234567` both match */
+                contact_phone?: string;
+                /** @description The company to link, by the same `external_id` you upserted it with */
+                external_id: string;
+            }[];
+        };
+        LinkContactCompanyDto: {
+            external_id: string;
+        };
         MakeOutboundCallDto: {
             phoneAgentId: string;
             contact: {
@@ -5782,9 +5810,9 @@ export interface components {
         CreateSessionCommentInput: {
             /**
              * Format: uuid
-             * @description Message UUID to comment on
+             * @description Message UUID to attach the comment to. Omit to create a session-level note (not attached to any message).
              */
-            thread_id: string;
+            thread_id?: string;
             /** @description Comment text content */
             content: string;
             /** @description Agent user ID that authors the comment */
@@ -5858,23 +5886,6 @@ export interface components {
              */
             limit: number;
         };
-        UpsertCompanyDto: {
-            external_id: string;
-            name?: string;
-            custom_data?: {
-                [key: string]: string | number | boolean | null;
-            };
-        };
-        BulkLinkContactsDto: {
-            links: {
-                /** Format: uuid */
-                contact_id: string;
-                external_id: string;
-            }[];
-        };
-        LinkContactCompanyDto: {
-            external_id: string;
-        };
         UpdatePublicKnowledgebaseItem: {
             /** @description Contact segment ids this item should be restricted to. Pass [] to make it available to all contacts. */
             restricted_to_segments?: string[];
@@ -6636,6 +6647,7 @@ export interface components {
                 })[];
             })[] | null;
             rejected_reason?: string | null;
+            message_send_ttl_seconds?: number | null;
         };
         PhoneCallEventDto: {
             /** Format: uuid */
@@ -6743,7 +6755,7 @@ export interface components {
                         /** @constant */
                         type: "response_skipped";
                         /** @enum {string} */
-                        reason?: "empty_response" | "potential_answers_dead_end" | "silent_handoff" | "superseded_by_newer_run" | "flagged_as_spam";
+                        reason?: "empty_response" | "potential_answers_dead_end" | "silent_handoff" | "assist_human_handling_recommended" | "superseded_by_newer_run" | "flagged_as_spam";
                         reasoning?: ({
                             /** @constant */
                             type: "reasoning";
@@ -7279,6 +7291,63 @@ export interface components {
                 customDataKeys?: string[];
             }[];
         };
+        Company: {
+            /** Format: uuid */
+            id: string;
+            /** @description The organization's own key for this company */
+            external_id: string;
+            name: string;
+            custom_data: {
+                [key: string]: string | number | boolean;
+            } | null;
+            /** @description ISO 8601 timestamp of when the company was created */
+            created_at: string;
+            /** @description ISO 8601 timestamp of when the company was last updated */
+            updated_at: string;
+        };
+        ListCompaniesOutput: {
+            data: components["schemas"]["Company"][];
+            total: number;
+            page: number;
+            limit: number;
+        };
+        GetContactCompaniesOutput: {
+            /** @description Empty when the contact belongs to no company */
+            companies: components["schemas"]["Company"][];
+        };
+        LinkContactCompanyOutput: {
+            /**
+             * @description `unchanged` means the contact was already in this company.
+             * @enum {string}
+             */
+            outcome: "linked" | "unchanged";
+            company: components["schemas"]["Company"];
+        };
+        BulkLinkContactsOutput: {
+            /** @description One entry per requested link, in request order */
+            results: {
+                /** @description The resolved contact id. Null when the identifier did not resolve. */
+                contact_id: string | null;
+                external_id: string;
+                outcome: ("linked" | "unchanged") | null;
+                /** @description Null when this contact linked successfully */
+                error: string | null;
+                company: components["schemas"]["Company"] | null;
+            }[];
+            summary: {
+                total: number;
+                linked: number;
+                unchanged: number;
+                failed: number;
+            };
+        };
+        UnlinkContactCompanyOutput: {
+            /**
+             * @description `unchanged` means the contact was not in that company.
+             * @enum {string}
+             */
+            outcome: "unlinked" | "unchanged";
+        };
         PhoneAgentDto: {
             id: string;
             org_id: string;
@@ -9230,62 +9299,6 @@ export interface components {
                 };
             };
         };
-        Company: {
-            /** Format: uuid */
-            id: string;
-            /** @description The organization's own key for this company */
-            external_id: string;
-            name: string;
-            custom_data: {
-                [key: string]: string | number | boolean;
-            } | null;
-            /** @description ISO 8601 timestamp of when the company was created */
-            created_at: string;
-            /** @description ISO 8601 timestamp of when the company was last updated */
-            updated_at: string;
-        };
-        ListCompaniesOutput: {
-            data: components["schemas"]["Company"][];
-            total: number;
-            page: number;
-            limit: number;
-        };
-        GetContactCompaniesOutput: {
-            /** @description Empty when the contact belongs to no company */
-            companies: components["schemas"]["Company"][];
-        };
-        LinkContactCompanyOutput: {
-            /**
-             * @description `unchanged` means the contact was already in this company.
-             * @enum {string}
-             */
-            outcome: "linked" | "unchanged";
-            company: components["schemas"]["Company"];
-        };
-        BulkLinkContactsOutput: {
-            /** @description One entry per requested link, in request order */
-            results: {
-                contact_id: string;
-                external_id: string;
-                outcome: ("linked" | "unchanged") | null;
-                /** @description Null when this contact linked successfully */
-                error: string | null;
-                company: components["schemas"]["Company"] | null;
-            }[];
-            summary: {
-                total: number;
-                linked: number;
-                unchanged: number;
-                failed: number;
-            };
-        };
-        UnlinkContactCompanyOutput: {
-            /**
-             * @description `unchanged` means the contact was not in that company.
-             * @enum {string}
-             */
-            outcome: "unlinked" | "unchanged";
-        };
         ContactSegment: {
             id: string;
             name: string;