@opencx/mcp 1.15.13 → 1.15.14

package/dist/phone-tools.spec.d.ts

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

package/dist/phone-tools.spec.d.ts.map

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

package/dist/phone-tools.spec.js

@@ -0,0 +1,156 @@
+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) {
+    return new Response(JSON.stringify(body), { status, statusText: 'OK' });
+}
+function getRequestUrl(call) {
+    const arg = call[0];
+    return arg instanceof Request ? arg.url : String(arg);
+}
+function getRequestMethod(call) {
+    const arg = call[0];
+    if (arg instanceof Request)
+        return arg.method;
+    return call[1].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 body = call[1].body;
+    return body ? JSON.parse(body) : undefined;
+}
+const agentFixture = {
+    id: 'agent-1',
+    name: 'Agent',
+    model: 'oppie-vox-livekit',
+    actionIds: [],
+    transfer_destination_ids: [],
+};
+describe('phone 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('list_transfer_destinations reads GET /phone/transfer-destinations', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse([{ id: 'dest-1', name: 'Support', type: 'phone', hasSipPassword: false }]));
+        const result = await client.callTool({ name: 'list_transfer_destinations', arguments: {} });
+        expect(result.isError).toBeFalsy();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/phone/transfer-destinations');
+        expect(getRequestMethod(call)).toBe('GET');
+        expect(JSON.stringify(result.content)).toContain('dest-1');
+    });
+    it('create_phone_agent forwards actions, destinations and voice tuning fields verbatim', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(agentFixture));
+        const result = await client.callTool({
+            name: 'create_phone_agent',
+            arguments: {
+                name: 'Agent',
+                actionIds: ['act-1'],
+                transfer_destination_ids: ['dest-1'],
+                failover_transfer_destination_id: 'dest-1',
+                tts_speed_pct: 83,
+                stt_keyterms: ['OpenCX'],
+                recording_enabled: true,
+            },
+        });
+        expect(result.isError).toBeFalsy();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/phone');
+        expect(getRequestMethod(call)).toBe('POST');
+        expect(await getRequestBody(call)).toEqual({
+            name: 'Agent',
+            actionIds: ['act-1'],
+            transfer_destination_ids: ['dest-1'],
+            failover_transfer_destination_id: 'dest-1',
+            tts_speed_pct: 83,
+            stt_keyterms: ['OpenCX'],
+            recording_enabled: true,
+        });
+    });
+    it('create/update no longer expose the legacy handoff_phone_number / use_org_knowledgebase inputs', async () => {
+        const { tools } = await client.listTools();
+        for (const name of ['create_phone_agent', 'update_phone_agent']) {
+            const tool = tools.find((t) => t.name === name);
+            expect(tool, name).toBeDefined();
+            const properties = Object.keys(tool?.inputSchema.properties ?? {});
+            expect(properties).not.toContain('handoff_phone_number');
+            expect(properties).not.toContain('use_org_knowledgebase');
+            expect(properties).toEqual(expect.arrayContaining(['actionIds', 'transfer_destination_ids', 'tts_speed_pct']));
+        }
+    });
+    it('update_phone_agent PATCHes only the supplied fields', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(agentFixture));
+        await client.callTool({
+            name: 'update_phone_agent',
+            arguments: { phone_agent_id: 'agent-1', transfer_destination_ids: [] },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/phone/agent-1');
+        expect(getRequestMethod(call)).toBe('PATCH');
+        expect(await getRequestBody(call)).toEqual({ transfer_destination_ids: [] });
+    });
+    it('make_outbound_call maps session_custom_data / extra_instructions onto the API body', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ sessionId: 's-1', callId: 'c-1' }));
+        const result = await client.callTool({
+            name: 'make_outbound_call',
+            arguments: {
+                phone_agent_id: 'agent-1',
+                phone_number: '+15551234567',
+                session_custom_data: { npsScore: 3, business: 'Cafe', owner: true },
+                extra_instructions: 'Ask about the last order.',
+            },
+        });
+        expect(result.isError).toBeFalsy();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toBe('https://api.test.com/phone/outbound-call');
+        expect(await getRequestBody(call)).toEqual({
+            phoneAgentId: 'agent-1',
+            contact: { phoneNumber: '+15551234567' },
+            sessionCustomData: { npsScore: 3, business: 'Cafe', owner: true },
+            extraInstructions: 'Ask about the last order.',
+        });
+    });
+    it('make_outbound_call omits the optional extras when not provided', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ sessionId: 's-1', callId: 'c-1' }));
+        await client.callTool({
+            name: 'make_outbound_call',
+            arguments: { phone_agent_id: 'agent-1', contact_id: 'contact-1' },
+        });
+        const call = fetchSpy.mock.calls[0];
+        expect(await getRequestBody(call)).toEqual({
+            phoneAgentId: 'agent-1',
+            contact: { id: 'contact-1' },
+        });
+    });
+    it('make_outbound_call rejects a call with neither contact nor number without hitting the API', async () => {
+        const result = await client.callTool({
+            name: 'make_outbound_call',
+            arguments: { phone_agent_id: 'agent-1' },
+        });
+        expect(result.isError).toBe(true);
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=phone-tools.spec.js.map

package/dist/phone-tools.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-tools.spec.js","sourceRoot":"","sources":["../src/phone-tools.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;IAC/C,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACxD,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,OAAQ,IAAI,CAAC,CAAC,CAAiB,CAAC,MAAM,IAAI,KAAK,CAAC;AAClD,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,GAAI,IAAI,CAAC,CAAC,CAAiB,CAAC,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,EAAE;IACb,wBAAwB,EAAE,EAAE;CAC7B,CAAC;AAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,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;QACtC,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,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,QAAQ,CAAC,qBAAqB,CAC5B,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CACxF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAE5F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACrF,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACnC,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,CAAC,OAAO,CAAC;gBACpB,wBAAwB,EAAE,CAAC,QAAQ,CAAC;gBACpC,gCAAgC,EAAE,QAAQ;gBAC1C,aAAa,EAAE,EAAE;gBACjB,YAAY,EAAE,CAAC,QAAQ,CAAC;gBACxB,iBAAiB,EAAE,IAAI;aACxB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC/D,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,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,wBAAwB,EAAE,CAAC,QAAQ,CAAC;YACpC,gCAAgC,EAAE,QAAQ;YAC1C,aAAa,EAAE,EAAE;YACjB,YAAY,EAAE,CAAC,QAAQ,CAAC;YACxB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+FAA+F,EAAE,KAAK,IAAI,EAAE;QAC7G,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;YACzD,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;YAC1D,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CACxB,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,0BAA0B,EAAE,eAAe,CAAC,CAAC,CACnF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAE3D,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,wBAAwB,EAAE,EAAE,EAAE;SACvE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACvE,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,wBAAwB,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAElF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACnC,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE;gBACT,cAAc,EAAE,SAAS;gBACzB,YAAY,EAAE,cAAc;gBAC5B,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;gBACnE,kBAAkB,EAAE,2BAA2B;aAChD;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,YAAY,EAAE,SAAS;YACvB,OAAO,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE;YACxC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;YACjE,iBAAiB,EAAE,2BAA2B;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAElF,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE;SAClE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACjD,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,YAAY,EAAE,SAAS;YACvB,OAAO,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2FAA2F,EAAE,KAAK,IAAI,EAAE;QACzG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACnC,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE;SACzC,CAAC,CAAC;QACH,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

@@ -511,6 +511,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/chat/sessions/{session_id}/comments/{comment_uuid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a session comment
+         * @description Soft-deletes an internal comment. Only the comment's author may delete it. The acting agent is passed as the `agent_id` query parameter.
+         */
+        delete: operations["deleteChatSessionComment"];
+        options?: never;
+        head?: never;
+        /**
+         * Update a session comment
+         * @description Replaces the content of an internal comment. Only the comment's author may edit it, and a deleted comment can no longer be edited.
+         */
+        patch: operations["updateChatSessionComment"];
+        trace?: never;
+    };
     "/chat/sessions/{session_id}/history": {
         parameters: {
             query?: never;
@@ -2410,7 +2434,7 @@ export interface paths {
         };
         /**
          * List available voices
-         * @description List available voices for AI phone agents. Supports filtering by language, gender, accent, use_case, and free-text search. Use limit/offset for pagination. Use the voice_id when creating or updating a phone agent.
+         * @description List the curated voices available for AI phone agents. Supports filtering by language, gender, accent, use_case, and free-text search. Use limit/offset for pagination. Use the voice_id when creating or updating a phone agent.
          */
         get: operations["listVoices"];
         put?: never;
@@ -2445,6 +2469,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/phone/transfer-destinations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List transfer destinations
+         * @description List the transfer destinations configured for your organization (phone numbers, SIP endpoints, teams, or hang-up handbacks). Reference their IDs in transfer_destination_ids when creating or updating a phone agent; the agent can then transfer calls to them by name. Destinations are created and edited in the dashboard (Settings → SIP).
+         */
+        get: operations["listPhoneTransferDestinations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/phone/{phone_agent_id}/knowledge-sources": {
         parameters: {
             query?: never;
@@ -2954,7 +2998,7 @@ export interface paths {
         put?: never;
         /**
          * Create a training directory
-         * @description Create a new directory for organizing trainings.
+         * @description Create a new directory for organizing trainings. Pass parent_id to create it as a sub-directory.
          */
         post: operations["createTrainingDirectory"];
         delete?: never;
@@ -2973,7 +3017,7 @@ export interface paths {
         get?: never;
         /**
          * Update a training directory
-         * @description Rename a training directory.
+         * @description Rename and/or move a training directory. parent_id null moves it to the top level. Moving a directory under itself or one of its own sub-directories is rejected.
          */
         put: operations["updateTrainingDirectory"];
         post?: never;
@@ -3273,6 +3317,30 @@ export interface paths {
         get: operations["getOrgUser"];
         put?: never;
         post?: never;
+        /**
+         * Remove a user from the organization
+         * @description Remove a user's organization membership. Also removes their team memberships and availability in this organization and signs them out everywhere. Their account and historical activity are preserved, and memberships in other organizations are unaffected. The organization owner cannot be removed.
+         */
+        delete: operations["deleteOrgUser"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/users/batch-delete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Remove multiple users from the organization
+         * @description Remove up to 25 users from the organization in one call. Users are processed independently — one failure never aborts the rest — and the response reports a status per user. Same semantics as removing a single user.
+         */
+        post: operations["batchDeleteOrgUsers"];
         delete?: never;
         options?: never;
         head?: never;
@@ -5819,6 +5887,13 @@ export interface components {
             agent_id: number;
             attachments?: components["schemas"]["ChatAttachmentInput"][];
         };
+        UpdateSessionCommentInput: {
+            /** @description Replacement comment text content */
+            content: string;
+            /** @description Agent user ID performing the edit. Only the note's author may edit it. */
+            agent_id: number;
+            attachments?: components["schemas"]["ChatAttachmentInput"][];
+        };
         FilterSessionsPublicDto: {
             /** @default {} */
             filters: {
@@ -5976,18 +6051,24 @@ export interface components {
             type?: "inbound" | "outbound";
             /** @description Voice ID from the /phone/voices endpoint. Omit for default voice. */
             voice_id?: string | null;
-            /** @description ISO-639-1 language codes the agent should speak. A subset of {en, es, fr, de, hi, ru, pt, ja, it, nl} can be combined freely. Any other code (e.g. "ar", "tr", "zh") must be the only entry. */
+            /** @description ISO-639-1 language codes the agent should speak. A subset of {en, es, fr, de, hi, ru, pt, ja, it, nl} can be combined freely. Any other code (e.g. "ar", "tr", "zh") must be the only entry; Arabic accepts dialect tags such as "ar-SA". */
             language?: string[];
             /** @description What the agent says when it picks up (default: "Hello?") */
             first_message?: string | null;
-            /** @description Training scenario IDs to attach to this agent */
+            /** @description The call prompt as an array of instruction blocks. Joined in order into the system prompt at call time. Sending this on update replaces the whole array. */
             instructions?: string[] | null;
-            /** @description Phone number to transfer to when handing off to a human (E.164 format) */
-            handoff_phone_number?: string | null;
-            /** @description Whether the agent can search your knowledge base during calls (default: false) */
-            use_org_knowledgebase?: boolean | null;
-            /** @description Action IDs the agent can call during conversations */
+            /** @description HTTP actions the agent can call as tools during calls (action IDs from GET /actions). The full set is replaced on every write; send [] to detach all, omit or send null to leave it unchanged. IDs must belong to your organization. */
             actionIds?: string[] | null;
+            /** @description Transfer destinations the agent may transfer calls to (IDs from GET /phone/transfer-destinations). The full set is replaced on every write; send [] to detach all. Destinations themselves are managed in the dashboard. */
+            transfer_destination_ids?: string[];
+            /** @description Destination the call is transferred to if the voice pipeline fails mid-call. Any destination of your organization; null falls back to the first allowed destination, then to a graceful hangup. */
+            failover_transfer_destination_id?: string | null;
+            /** @description Speaking speed on a 1-100 scale (null = the voice default). Lower is slower; natural-sounding voices in some languages (e.g. Dutch) run best around 80-85. */
+            tts_speed_pct?: number | null;
+            /** @description Custom vocabulary to boost in speech recognition: brand and product names, jargon, spellings the transcriber typically mishears. The agent name and transfer destination names are merged in automatically. */
+            stt_keyterms?: string[] | null;
+            /** @description Record calls handled by this agent (default: false). */
+            recording_enabled?: boolean;
         };
         UpdatePhoneAgentPublicDto: {
             /** @description Agent display name */
@@ -5999,18 +6080,24 @@ export interface components {
             type?: "inbound" | "outbound";
             /** @description Voice ID from the /phone/voices endpoint. Omit for default voice. */
             voice_id?: string | null;
-            /** @description ISO-639-1 language codes the agent should speak. A subset of {en, es, fr, de, hi, ru, pt, ja, it, nl} can be combined freely. Any other code (e.g. "ar", "tr", "zh") must be the only entry. */
+            /** @description ISO-639-1 language codes the agent should speak. A subset of {en, es, fr, de, hi, ru, pt, ja, it, nl} can be combined freely. Any other code (e.g. "ar", "tr", "zh") must be the only entry; Arabic accepts dialect tags such as "ar-SA". */
             language?: string[];
             /** @description What the agent says when it picks up (default: "Hello?") */
             first_message?: string | null;
-            /** @description Training scenario IDs to attach to this agent */
+            /** @description The call prompt as an array of instruction blocks. Joined in order into the system prompt at call time. Sending this on update replaces the whole array. */
             instructions?: string[] | null;
-            /** @description Phone number to transfer to when handing off to a human (E.164 format) */
-            handoff_phone_number?: string | null;
-            /** @description Whether the agent can search your knowledge base during calls (default: false) */
-            use_org_knowledgebase?: boolean | null;
-            /** @description Action IDs the agent can call during conversations */
+            /** @description HTTP actions the agent can call as tools during calls (action IDs from GET /actions). The full set is replaced on every write; send [] to detach all, omit or send null to leave it unchanged. IDs must belong to your organization. */
             actionIds?: string[] | null;
+            /** @description Transfer destinations the agent may transfer calls to (IDs from GET /phone/transfer-destinations). The full set is replaced on every write; send [] to detach all. Destinations themselves are managed in the dashboard. */
+            transfer_destination_ids?: string[];
+            /** @description Destination the call is transferred to if the voice pipeline fails mid-call. Any destination of your organization; null falls back to the first allowed destination, then to a graceful hangup. */
+            failover_transfer_destination_id?: string | null;
+            /** @description Speaking speed on a 1-100 scale (null = the voice default). Lower is slower; natural-sounding voices in some languages (e.g. Dutch) run best around 80-85. */
+            tts_speed_pct?: number | null;
+            /** @description Custom vocabulary to boost in speech recognition: brand and product names, jargon, spellings the transcriber typically mishears. The agent name and transfer destination names are merged in automatically. */
+            stt_keyterms?: string[] | null;
+            /** @description Record calls handled by this agent (default: false). */
+            recording_enabled?: boolean;
         };
         WriteSecretInputDto: {
             /** @description The reference key actions and workflows use as {{secrets.<name>}}. Unique per organization, and immutable — writing the same name replaces its value rather than renaming anything. */
@@ -6119,6 +6206,10 @@ export interface components {
             /** @description Pre-rendered TipTap diff HTML */
             diff_html: string;
         };
+        BatchDeleteOrgUsersDto: {
+            /** @description Organization user IDs to remove (duplicates are collapsed) */
+            user_ids: number[];
+        };
         PublicApproveSuggestionDto: {
             /**
              * Format: uuid
@@ -6451,10 +6542,14 @@ export interface components {
         CreateTrainingDirectoryInputDto: {
             /** @description The directory name */
             name: string;
+            /** @description Parent directory id. Omit or null for a top-level directory. */
+            parent_id?: string | null;
         };
         UpdateTrainingDirectoryInputDto: {
             /** @description The new directory name */
-            name: string;
+            name?: string;
+            /** @description New parent directory id, or null for top level. Omit to keep the current parent. */
+            parent_id?: string | null;
         };
         UpdateAiProfileInput: {
             name?: string;
@@ -7249,6 +7344,8 @@ export interface components {
             id: string;
             name: string;
             org_id: string;
+            /** @description Parent folder id; null for a top-level folder. */
+            parent_id: string | null;
         };
         SankeyReportResDto: {
             nodes: {
@@ -7348,6 +7445,24 @@ export interface components {
              */
             outcome: "unlinked" | "unchanged";
         };
+        TransferDestinationDto: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+            /** @enum {string} */
+            type: "hangup" | "phone" | "sip" | "team";
+            value: string | null;
+            sipUsername: string | null;
+            hasSipPassword: boolean;
+            sipHost: string | null;
+            sipPort: number | null;
+            sipExtension: string | null;
+            sipTransport: ("udp" | "tcp" | "tls") | null;
+            sipCallerId: string | null;
+            routingGroupId: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
         PhoneAgentDto: {
             id: string;
             org_id: string;
@@ -7382,6 +7497,8 @@ export interface components {
             stt_model: ("deepgram/flux-general" | "deepgram/nova-3" | "deepgram/nova-3-medical" | "cartesia/ink-whisper" | "elevenlabs/scribe_v2_realtime" | "xai/stt-1" | "assemblyai/universal-3-5-pro" | "speechmatics/enhanced" | "soniox/stt-rt-v5") | null;
             tts_speed_pct: number | null;
             failover_transfer_destination_id: string | null;
+            /** @description Transfer destinations the agent may transfer to (`transfer_call` targets). */
+            transfer_destination_ids: string[];
         };
         PhoneAgentVoiceDto: {
             voice_id: string;
@@ -7423,6 +7540,8 @@ export interface components {
         KnowledgeSourceDirectoryDto: {
             id: string;
             name: string;
+            /** @description Parent directory id; null for a top-level directory */
+            parent_id: string | null;
             items: components["schemas"]["KnowledgeSourceTreeItemDto"][];
             /** @description Whether the entire directory is selected (all current and future instructions included) */
             selected: boolean;
@@ -9861,6 +9980,8 @@ export interface components {
             id: string;
             name: string;
             org_id: string;
+            /** @description Parent folder id; null for a top-level folder. */
+            parent_id: string | null;
             items: components["schemas"]["TrainingPublicResponseDto"][];
         };
         TrainingDirectoryTreePublicDto: {
@@ -9889,6 +10010,16 @@ export interface components {
                 is_user_available_on_group: boolean;
             }[];
         };
+        BatchDeleteOrgUsersResultDto: {
+            results: {
+                user_id: number;
+                /**
+                 * @description deleted: membership removed; not_found: not a member of this organization; owner_blocked: the organization owner cannot be removed; error: removal failed, retry later
+                 * @enum {string}
+                 */
+                status: "deleted" | "not_found" | "owner_blocked" | "error";
+            }[];
+        };
         PublicInsight: {
             /** Format: uuid */
             id: string;
@@ -10469,6 +10600,7 @@ export interface components {
         GetWorkflowRunLogsOutput: components["schemas"]["WorkflowRunLogEntryDto"][];
         ListVoicesOutput: components["schemas"]["PhoneAgentVoiceDto"][];
         ListPhoneAgentsOutput: components["schemas"]["PhoneAgentDto"][];
+        ListTransferDestinationsOutput: components["schemas"]["TransferDestinationDto"][];
         GetSequenceOutput: components["schemas"]["SequenceDto"];
         ListTrainingsOutput: {
             items: components["schemas"]["TrainingPublicResponseDto"][];
@@ -11595,6 +11727,79 @@ export interface operations {
             };
         };
     };
+    deleteChatSessionComment: {
+        parameters: {
+            query: {
+                /** @description Agent user ID performing the deletion. Only the note's author may delete it. */
+                agent_id: number;
+            };
+            header?: never;
+            path: {
+                /** @description The unique identifier of the chat session */
+                session_id: string;
+                /** @description The unique identifier of the comment */
+                comment_uuid: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    updateChatSessionComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The unique identifier of the chat session */
+                session_id: string;
+                /** @description The unique identifier of the comment */
+                comment_uuid: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateSessionCommentInput"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatHistoryDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     listChatHistory: {
         parameters: {
             query?: {
@@ -15680,6 +15885,35 @@ export interface operations {
             };
         };
     };
+    listPhoneTransferDestinations: {
+        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"]["ListTransferDestinationsOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     getPhoneAgentKnowledgeSources: {
         parameters: {
             query?: never;
@@ -17565,6 +17799,69 @@ export interface operations {
             };
         };
     };
+    deleteOrgUser: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Organization user ID */
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    batchDeleteOrgUsers: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchDeleteOrgUsersDto"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchDeleteOrgUsersResultDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     inviteUser: {
         parameters: {
             query?: never;