@opencx/mcp 1.15.15 → 1.15.21

package/dist/companies.spec.js

@@ -0,0 +1,191 @@
+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;
+}
+function contentJson(content) {
+    const parsed = content;
+    return JSON.parse(parsed[0].text);
+}
+const COMPANY = {
+    id: 'c1',
+    external_id: 'acct-1',
+    name: 'Acme Retail',
+    custom_data: { plan: 'growth' },
+    agent_owner: { id: 7, name: 'Dana', email: 'dana@open.cx' },
+    created_at: '2026-08-22T00:00:00.000Z',
+    updated_at: '2026-08-22T00:00:00.000Z',
+};
+describe('company tools', () => {
+    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.restoreAllMocks();
+    });
+    it('registers all eight company tools', async () => {
+        const { tools } = await client.listTools();
+        const toolNames = tools.map((t) => t.name);
+        expect(toolNames).toContain('list_companies');
+        expect(toolNames).toContain('get_company');
+        expect(toolNames).toContain('upsert_company');
+        expect(toolNames).toContain('set_company_owner');
+        expect(toolNames).toContain('list_contact_companies');
+        expect(toolNames).toContain('link_contact_to_company');
+        expect(toolNames).toContain('link_contacts_to_companies');
+        expect(toolNames).toContain('unlink_contact_from_company');
+    });
+    it('list_companies GETs /companies and returns the owner', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ data: [COMPANY], total: 1, page: 1, limit: 50 }));
+        const result = await client.callTool({ name: 'list_companies', arguments: {} });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/companies');
+        expect(getRequestMethod(call)).toBe('GET');
+        // The owner has to survive the wrapper — it is the whole point of the tool
+        // for an operator asking "who owns this account?".
+        const body = contentJson(result.content);
+        expect(body.data[0]?.agent_owner?.email).toBe('dana@open.cx');
+    });
+    it('get_company GETs the per-company route', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(COMPANY));
+        await client.callTool({ name: 'get_company', arguments: { company_id: 'c1' } });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/companies/c1');
+        expect(getRequestMethod(call)).toBe('GET');
+    });
+    it('upsert_company POSTs /companies with the external key', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(COMPANY, 201, 'Created'));
+        await client.callTool({
+            name: 'upsert_company',
+            arguments: { external_id: 'acct-1', name: 'Acme Retail', custom_data: { plan: 'growth' } },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/companies');
+        expect(getRequestMethod(call)).toBe('POST');
+        expect(await getRequestBody(call)).toEqual({
+            external_id: 'acct-1',
+            name: 'Acme Retail',
+            custom_data: { plan: 'growth' },
+        });
+    });
+    it('set_company_owner PUTs the owner route with the email', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(COMPANY));
+        await client.callTool({
+            name: 'set_company_owner',
+            arguments: { external_id: 'acct-1', owner: { email: 'dana@open.cx' } },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/companies/acct-1/owner');
+        expect(getRequestMethod(call)).toBe('PUT');
+        // external_id belongs in the path, never the body.
+        expect(await getRequestBody(call)).toEqual({ owner: { email: 'dana@open.cx' } });
+    });
+    it('set_company_owner passes an explicit null through to clear the owner', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ ...COMPANY, agent_owner: null }));
+        await client.callTool({
+            name: 'set_company_owner',
+            arguments: { external_id: 'acct-1', owner: null },
+        });
+        const call = fetchSpy.mock.calls[0];
+        // A dropped null would read as "no owner given" and be rejected instead of
+        // clearing, so the null has to survive serialization.
+        expect(await getRequestBody(call)).toEqual({ owner: null });
+    });
+    it('upsert_company carries an owner through in one call', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(COMPANY, 201, 'Created'));
+        await client.callTool({
+            name: 'upsert_company',
+            arguments: {
+                external_id: 'acct-1',
+                name: 'Acme Retail',
+                owner: { email: 'dana@open.cx' },
+            },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(await getRequestBody(call)).toEqual({
+            external_id: 'acct-1',
+            name: 'Acme Retail',
+            owner: { email: 'dana@open.cx' },
+        });
+    });
+    it('list_contact_companies GETs the contact route', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ companies: [COMPANY] }));
+        await client.callTool({ name: 'list_contact_companies', arguments: { contact_id: 'ct1' } });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/contacts/ct1/companies');
+        expect(getRequestMethod(call)).toBe('GET');
+    });
+    it('link_contact_to_company POSTs the company key to the contact route', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ outcome: 'linked', company: COMPANY }, 201, 'Created'));
+        await client.callTool({
+            name: 'link_contact_to_company',
+            arguments: { contact_id: 'ct1', external_id: 'acct-1' },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/contacts/ct1/companies');
+        expect(getRequestMethod(call)).toBe('POST');
+        expect(await getRequestBody(call)).toEqual({ external_id: 'acct-1' });
+    });
+    it('link_contacts_to_companies POSTs the batch to /companies/links', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ results: [], summary: { total: 0, linked: 0, unchanged: 0, failed: 0 } }, 201, 'Created'));
+        await client.callTool({
+            name: 'link_contacts_to_companies',
+            arguments: { links: [{ contact_email: 'a@open.cx', external_id: 'acct-1' }] },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/companies/links');
+        expect(getRequestMethod(call)).toBe('POST');
+        expect(await getRequestBody(call)).toEqual({
+            links: [{ contact_email: 'a@open.cx', external_id: 'acct-1' }],
+        });
+    });
+    it('unlink_contact_from_company DELETEs one named company', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ outcome: 'unlinked' }));
+        await client.callTool({
+            name: 'unlink_contact_from_company',
+            arguments: { contact_id: 'ct1', external_id: 'acct-1' },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/contacts/ct1/companies/acct-1');
+        expect(getRequestMethod(call)).toBe('DELETE');
+    });
+});
+//# sourceMappingURL=companies.spec.js.map

package/dist/companies.spec.js.map

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

package/dist/phone-caller-number-tool.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=phone-caller-number-tool.spec.d.ts.map

package/dist/phone-caller-number-tool.spec.d.ts.map

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

package/dist/phone-caller-number-tool.spec.js

@@ -0,0 +1,97 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { createServer } from './server.js';
+// The caller-number attach tool, from the agent's side of the wire. The
+// error-path test exists because of a specific failure: the first cut
+// destructured `{ error }` from the client — unreachable, since the client
+// middleware THROWS on any non-ok response — so a 400 surfaced as a thrown
+// exception ("the tool is broken") instead of explainable data.
+function mockResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), { status, statusText: 'X' });
+}
+function requestUrl(call) {
+    const arg = call[0];
+    return arg instanceof Request ? arg.url : String(arg);
+}
+async function requestBody(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;
+}
+/** The tool's single text-content JSON payload, parsed — never a cast. */
+function parseToolJson(content) {
+    const [first] = z.array(z.object({ type: z.string(), text: z.string() })).parse(content);
+    if (!first)
+        throw new Error('tool returned no content');
+    return z.record(z.string(), z.unknown()).parse(JSON.parse(first.text));
+}
+describe('set_phone_agent_caller_number 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.restoreAllMocks();
+    });
+    it('is declared, and PUTs the caller number to the right path', async () => {
+        fetchSpy.mockResolvedValue(mockResponse({ phone_agent_id: 'agent-1', caller_number: '+15005551234' }));
+        const result = await client.callTool({
+            name: 'set_phone_agent_caller_number',
+            arguments: { phone_agent_id: 'agent-1', caller_number: '+15005551234' },
+        });
+        expect(result.isError ?? false).toBe(false);
+        const call = fetchSpy.mock.calls[0];
+        expect(call).toBeDefined();
+        expect(requestUrl(call)).toContain('/phone/agent-1/caller-number');
+        expect(await requestBody(call)).toEqual({ caller_number: '+15005551234' });
+    });
+    it('detaches with null', async () => {
+        fetchSpy.mockResolvedValue(mockResponse({ phone_agent_id: 'agent-1', caller_number: null }));
+        const result = await client.callTool({
+            name: 'set_phone_agent_caller_number',
+            arguments: { phone_agent_id: 'agent-1', caller_number: null },
+        });
+        expect(result.isError ?? false).toBe(false);
+        expect(await requestBody(fetchSpy.mock.calls[0])).toEqual({ caller_number: null });
+    });
+    it('a 400 (unverified number) comes back as DATA the agent can explain — not a thrown error', async () => {
+        fetchSpy.mockResolvedValue(mockResponse({ message: 'caller_number is not a verified phone number' }, 400));
+        const result = await client.callTool({
+            name: 'set_phone_agent_caller_number',
+            arguments: { phone_agent_id: 'agent-1', caller_number: '+19998887777' },
+        });
+        // Not the SDK's exception envelope: our own structured refusal.
+        const payload = parseToolJson(result.content);
+        expect(payload).toMatchObject({ ok: false, status: 400 });
+        expect(JSON.stringify(payload)).toContain('not a verified phone number');
+    });
+    it('a 404 (foreign/missing agent) comes back as data too', async () => {
+        fetchSpy.mockResolvedValue(mockResponse({ message: 'Agent not found' }, 404));
+        const result = await client.callTool({
+            name: 'set_phone_agent_caller_number',
+            arguments: { phone_agent_id: 'nope', caller_number: null },
+        });
+        const payload = parseToolJson(result.content);
+        expect(payload).toMatchObject({ ok: false, status: 404 });
+    });
+});
+//# sourceMappingURL=phone-caller-number-tool.spec.js.map

package/dist/phone-caller-number-tool.spec.js.map

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