@opencx/mcp 1.15.28 → 1.15.29

package/dist/follow-up-tools.spec.d.ts

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

package/dist/follow-up-tools.spec.d.ts.map

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

package/dist/follow-up-tools.spec.js

@@ -0,0 +1,139 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { connectInMemory, fetchCallUrl, toolTextResultSchema } from './spec-helpers.js';
+import { jsonValueSchema } from './utils/json.js';
+function mockResponse(body, status = 200, statusText = 'OK') {
+    return new Response(JSON.stringify(body), { status, statusText });
+}
+function recordedCall(fetchSpy) {
+    const [call] = fetchSpy.mock.calls;
+    if (!call)
+        throw new Error('fetch was not called');
+    return call;
+}
+function callMethod(call) {
+    const [input, init] = call;
+    if (input instanceof Request)
+        return input.method;
+    return init?.method ?? 'GET';
+}
+async function callBody(call) {
+    const [input, init] = call;
+    const text = input instanceof Request ? await input.clone().text() : init?.body;
+    return typeof text === 'string' && text ? jsonValueSchema.parse(JSON.parse(text)) : undefined;
+}
+const followUp = {
+    id: 'fu-1',
+    session_id: '11111111-1111-4111-8111-111111111111',
+    ticket_number: 42,
+    prompt: 'check the export',
+    fire_at: '2026-09-05T15:00:00.000Z',
+    is_active: true,
+    created_at: '2026-09-05T14:55:00.000Z',
+};
+describe('follow-up 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.unstubAllGlobals();
+    });
+    it('registers all three tools with session_id as a required argument', async () => {
+        const { tools } = await client.listTools();
+        const names = tools.map((t) => t.name);
+        expect(names).toEqual(expect.arrayContaining(['schedule_followup', 'list_followups', 'cancel_followup']));
+        for (const name of ['schedule_followup', 'list_followups', 'cancel_followup']) {
+            const tool = tools.find((t) => t.name === name);
+            expect(tool?.inputSchema.required, name).toContain('session_id');
+        }
+        const schedule = tools.find((t) => t.name === 'schedule_followup');
+        expect(schedule?.description).toContain('continue THIS session later');
+        expect(schedule?.description).toContain('back off (5 → 15 → 60 minutes)');
+    });
+    it('schedule_followup POSTs to the session follow-ups route with the API body shape', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse(followUp, 201, 'Created'));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'schedule_followup',
+            arguments: { session_id: followUp.session_id, delay_minutes: 5, prompt: 'check the export' },
+        }));
+        const call = recordedCall(fetchSpy);
+        expect(fetchCallUrl(call)).toBe(`https://api.test.com/chat/sessions/${followUp.session_id}/follow-ups`);
+        expect(callMethod(call)).toBe('POST');
+        expect(await callBody(call)).toEqual({ delay_minutes: 5, prompt: 'check the export' });
+        expect(result.isError).toBeUndefined();
+        expect(JSON.parse(result.content[0].text)).toEqual(followUp);
+    });
+    it('schedule_followup rejects a delay outside 1–43200 or an empty prompt before calling the API', async () => {
+        for (const args of [
+            { session_id: 's', delay_minutes: 0, prompt: 'x' },
+            { session_id: 's', delay_minutes: 43201, prompt: 'x' },
+            { session_id: 's', delay_minutes: 2.5, prompt: 'x' },
+            { session_id: 's', delay_minutes: 5, prompt: '' },
+            { session_id: '', delay_minutes: 5, prompt: 'x' },
+        ]) {
+            const result = toolTextResultSchema.parse(await client.callTool({ name: 'schedule_followup', arguments: args }));
+            expect(result.isError, JSON.stringify(args)).toBe(true);
+        }
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('schedule_followup surfaces a cap refusal (409) as a tool error the model can act on', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ message: 'At most 5 pending follow-ups per session' }, 409, 'Conflict'));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'schedule_followup',
+            arguments: { session_id: 's', delay_minutes: 5, prompt: 'x' },
+        }));
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('cap reached');
+        expect(result.content[0].text).toContain('At most 5 pending');
+    });
+    it('schedule_followup tells the model not to retry when the feature is off (403)', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ message: 'nope' }, 403, 'Forbidden'));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'schedule_followup',
+            arguments: { session_id: 's', delay_minutes: 5, prompt: 'x' },
+        }));
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('not enabled');
+        expect(result.content[0].text).toContain('do not retry');
+    });
+    it('list_followups GETs the session follow-ups route', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ follow_ups: [followUp], limits: { max_active_per_session: 5, max_total_per_session: 50 } }));
+        const result = toolTextResultSchema.parse(await client.callTool({ name: 'list_followups', arguments: { session_id: 'abc' } }));
+        const call = recordedCall(fetchSpy);
+        expect(fetchCallUrl(call)).toBe('https://api.test.com/chat/sessions/abc/follow-ups');
+        expect(callMethod(call)).toBe('GET');
+        expect(JSON.parse(result.content[0].text).follow_ups).toEqual([followUp]);
+    });
+    it('cancel_followup DELETEs the follow-up route and returns the inactive follow-up', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ ...followUp, is_active: false }));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'cancel_followup',
+            arguments: { session_id: 'abc', follow_up_id: 'fu-1' },
+        }));
+        const call = recordedCall(fetchSpy);
+        expect(fetchCallUrl(call)).toBe('https://api.test.com/chat/sessions/abc/follow-ups/fu-1');
+        expect(callMethod(call)).toBe('DELETE');
+        expect(JSON.parse(result.content[0].text).is_active).toBe(false);
+    });
+    it('a 404 (foreign or unknown session / follow-up) is a tool error, not a crash', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ message: 'Not Found' }, 404, 'Not Found'));
+        const result = toolTextResultSchema.parse(await client.callTool({
+            name: 'cancel_followup',
+            arguments: { session_id: 'abc', follow_up_id: 'nope' },
+        }));
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('No such session or follow-up');
+    });
+    it('an unexpected API failure (500) still propagates as an error result', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ message: 'boom' }, 500, 'Internal Server Error'));
+        const result = toolTextResultSchema.parse(await client.callTool({ name: 'list_followups', arguments: { session_id: 'abc' } }));
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('500');
+    });
+});
+//# sourceMappingURL=follow-up-tools.spec.js.map

package/dist/follow-up-tools.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-up-tools.spec.js","sourceRoot":"","sources":["../src/follow-up-tools.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,SAAS,YAAY,CAAC,IAAe,EAAE,MAAM,GAAG,GAAG,EAAE,UAAU,GAAG,IAAI;IACpE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,QAAgD;IACpE,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,IAAI,KAAK,YAAY,OAAO;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAClD,OAAO,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAe;IACrC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;IAChF,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChG,CAAC;AAED,MAAM,QAAQ,GAAG;IACf,EAAE,EAAE,MAAM;IACV,UAAU,EAAE,sCAAsC;IAClD,aAAa,EAAE,EAAE;IACjB,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,0BAA0B;IACnC,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,0BAA0B;CACvC,CAAC;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,MAAc,CAAC;IACnB,IAAI,OAA4B,CAAC;IACjC,IAAI,QAAgD,CAAC;IAErD,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAgB,CAAC;QACjC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC,CAAC;IAClD,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,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CACnB,MAAM,CAAC,eAAe,CAAC,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC,CACnF,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACvE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC7F,CAAC,CACH,CAAC;QACF,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC7B,sCAAsC,QAAQ,CAAC,UAAU,aAAa,CACvE,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6FAA6F,EAAE,KAAK,IAAI,EAAE;QAC3G,KAAK,MAAM,IAAI,IAAI;YACjB,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;YAClD,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;YACtD,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;YACpD,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YACjD,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;SAClD,EAAE,CAAC;YACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CACtE,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACnG,QAAQ,CAAC,qBAAqB,CAC5B,YAAY,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,CACvF,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;SAC9D,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;SAC9D,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,QAAQ,CAAC,qBAAqB,CAC5B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,sBAAsB,EAAE,CAAC,EAAE,qBAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,CAC3G,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CACpF,CAAC;QACF,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QACrF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE;SACvD,CAAC,CACH,CAAC;QACF,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QAC1F,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE;SACvD,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CACpF,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/phone-agent-card-spec.spec.d.ts

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

package/dist/phone-agent-card-spec.spec.d.ts.map

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

package/dist/phone-agent-card-spec.spec.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { buildPhoneAgentCardSpec } from './tools/phone.js';
+/**
+ * The card a phone tool hands back is a ` ```spec ` fence of JSONL patch
+ * lines — the one format the widget stream, the widget's history parser, and
+ * the inbox all render. A whole-tree object would be dropped by the stream.
+ */
+describe('buildPhoneAgentCardSpec', () => {
+    it('emits root-first patch lines inside a spec fence', () => {
+        const fence = buildPhoneAgentCardSpec({ id: 'a1', name: 'Support line', model: 'oppie-vox-livekit' });
+        const lines = fence.split('\n');
+        expect(lines[0]).toBe('```spec');
+        expect(lines.at(-1)).toBe('```');
+        const patches = lines.slice(1, -1).map((line) => JSON.parse(line));
+        expect(patches).toEqual([
+            { op: 'add', path: '/root', value: 'phone-agent-a1' },
+            {
+                op: 'add',
+                path: '/elements/phone-agent-a1',
+                value: {
+                    type: 'PhoneAgentCard',
+                    props: { agentId: 'a1', agentName: 'Support line', model: 'oppie-vox-livekit' },
+                    children: [],
+                },
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=phone-agent-card-spec.spec.js.map

package/dist/phone-agent-card-spec.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-agent-card-spec.spec.js","sourceRoot":"","sources":["../src/phone-agent-card-spec.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAG,uBAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE;YACrD;gBACE,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,0BAA0B;gBAChC,KAAK,EAAE;oBACL,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBAC/E,QAAQ,EAAE,EAAE;iBACb;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/schema.d.ts

@@ -616,6 +616,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/chat/sessions/{session_id}/follow-ups": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the AI follow-ups scheduled on a chat session
+         * @description Every follow-up scheduled on this session, pending ones first. A follow-up stays listed after it fires or is cancelled, with `is_active` false.
+         */
+        get: operations["listChatSessionFollowUps"];
+        put?: never;
+        /**
+         * Schedule an AI follow-up on a chat session
+         * @description Schedules the AI to continue this session later with the given prompt as guidance. At most 5 pending and 50 total follow-ups per session (409 when exceeded). Requires the scheduled follow-ups feature (403 otherwise).
+         */
+        post: operations["createChatSessionFollowUp"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/chat/sessions/{session_id}/follow-ups/{follow_up_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Cancel a pending AI follow-up
+         * @description Cancels a pending follow-up so it never fires. Cancelling one that already fired or was cancelled is a no-op and returns it as is.
+         */
+        delete: operations["cancelChatSessionFollowUp"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/companies": {
         parameters: {
             query?: never;
@@ -3282,7 +3326,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Launch an outbound sequence — arms candidates for sending */
+        /**
+         * Launch an outbound sequence — arms candidates for sending
+         * @description If the launch preview carries a regulatory_notice (voice steps into regulated countries), show it to a person and pass regulatory_acknowledged: true so the confirmation is recorded with the notice text. Informational — never blocks.
+         */
         post: operations["launchSequence"];
         delete?: never;
         options?: never;
@@ -6213,6 +6260,8 @@ export interface components {
             support_office_hours_id?: string | null;
             /** @enum {string} */
             support_assignment_strategy?: "least-busy" | "round-robin" | "unassigned";
+            /** @description Seconds between automatic assignments to the same agent under the least-busy strategy: 0 turns pacing off, otherwise 15 to 3600. */
+            auto_assign_interval_seconds?: number;
         };
         CreateMiniAppDto: {
             name: string;
@@ -6517,6 +6566,10 @@ export interface components {
                 type?: "string" | "number" | "boolean" | "date" | "string[]" | "number[]";
             }[];
         };
+        LaunchSequenceInputDto: {
+            /** @description True when the user was shown the regulatory notice and confirmed it — recorded with the notice text as shown, purely as a record. Never required; the launch behaves identically without it. */
+            regulatory_acknowledged?: boolean | null;
+        };
         SetSequenceStepsDto: {
             /** @description The full step list, replacing whatever is stored. Same validation as create: step 0 must have delay_minutes 0. */
             steps: ({
@@ -7347,6 +7400,12 @@ export interface components {
              */
             limit: number;
         };
+        CreateChatSessionFollowUpInput: {
+            /** @description Minutes from now until the AI continues the session (1–43200, i.e. up to 30 days). The reply runs at the first whole minute at or after that moment. */
+            delay_minutes: number;
+            /** @description Guidance for the fired reply — what to check or say when the session is continued. Not shown to the contact. */
+            prompt: string;
+        };
         UpdatePublicKnowledgebaseItem: {
             /** @description Contact segment ids this item should be restricted to. Pass [] to make it available to all contacts. */
             restricted_to_segments?: string[];
@@ -7368,11 +7427,6 @@ export interface components {
             channel: "web" | "email" | "phone" | "whatsapp" | "slack" | "sms" | "instagram" | "messenger" | "api" | "web_voice";
             /** @description Set true to enable autopilot, false to disable */
             autopilot_enabled: boolean;
-            /**
-             * @description AI agent version to use for this channel
-             * @enum {string}
-             */
-            ai_agent_version?: "v1" | "v2";
         };
         UpdateProhibitedTopicsInputDto: {
             /** @description Full replacement list of prohibited topics. Each entry is either a name string or an object with a name and an optional description. A name-only entry keeps whatever description that topic already has. Empty array clears all topics. Duplicates and blank entries are removed. */
@@ -8303,7 +8357,7 @@ export interface components {
                         /** @constant */
                         type: "response_skipped";
                         /** @enum {string} */
-                        reason?: "empty_response" | "potential_answers_dead_end" | "silent_handoff" | "assist_human_handling_recommended" | "superseded_by_newer_run" | "flagged_as_spam";
+                        reason?: "empty_response" | "potential_answers_dead_end" | "silent_handoff" | "assist_human_handling_recommended" | "superseded_by_newer_run" | "interrupted" | "flagged_as_spam";
                         reasoning?: ({
                             /** @constant */
                             type: "reasoning";
@@ -8447,6 +8501,10 @@ export interface components {
                             id: string;
                             name: string;
                         }[];
+                        /** @default null */
+                        pacing_until: string | null;
+                        /** @default null */
+                        skip_reason: "pacing" | null;
                     } | null;
                     peers: {
                         agent_id: number;
@@ -8464,6 +8522,10 @@ export interface components {
                             id: string;
                             name: string;
                         }[];
+                        /** @default null */
+                        pacing_until: string | null;
+                        /** @default null */
+                        skip_reason: "pacing" | null;
                     }[];
                     /** @default [] */
                     required_skills: {
@@ -8549,6 +8611,10 @@ export interface components {
                             id: string;
                             name: string;
                         }[];
+                        /** @default null */
+                        pacing_until: string | null;
+                        /** @default null */
+                        skip_reason: "pacing" | null;
                     } | null;
                     peers: {
                         agent_id: number;
@@ -8566,6 +8632,10 @@ export interface components {
                             id: string;
                             name: string;
                         }[];
+                        /** @default null */
+                        pacing_until: string | null;
+                        /** @default null */
+                        skip_reason: "pacing" | null;
                     }[];
                     /** @default [] */
                     required_skills: {
@@ -9137,6 +9207,7 @@ export interface components {
             support_office_hours_id: string | null;
             /** @enum {string} */
             support_assignment_strategy: "least-busy" | "round-robin" | "unassigned";
+            auto_assign_interval_seconds: number;
             zendesk_group_id: string | null;
             zendesk_group_channels: components["schemas"]["SessionChannel"][] | null;
             created_at: string | null;
@@ -10275,6 +10346,49 @@ export interface components {
                 nullable: boolean;
             }[];
         };
+        SequenceRegulatoryNoticeDto: {
+            /** @description ISO 3166-1 alpha-2, sorted. */
+            countries: string[];
+            /** @description The checklist the confirmation refers to — show it with the country rules. */
+            points: string[];
+            cards: {
+                /** @description ISO 3166-1 alpha-2. */
+                code: string;
+                name: string;
+                /** @enum {string} */
+                consent: "opt_in" | "opt_out" | "opt_in_b2c_opt_out_b2b" | "unregulated" | "unknown";
+                consent_note: string;
+                hours: {
+                    weekdays: string;
+                    saturday: string;
+                    sunday: string;
+                    holidays: string;
+                    /** @enum {string} */
+                    clock: "called_party" | "national" | "unknown";
+                    /**
+                     * @description Say "required" only for statute/regulation; the rest is guidance.
+                     * @enum {string}
+                     */
+                    basis: "statute" | "regulation" | "code_of_conduct" | "regulator_guidance" | "partial" | "none" | "unknown";
+                    note: string;
+                };
+                frequency: string | null;
+                dnc: string;
+                ai_disclosure: string;
+                recording: string;
+                origination: string;
+                /** @enum {string} */
+                origination_kind: "foreign_origin_prohibited" | "local_number_required" | "dedicated_prefix_required" | "registered_series_required" | "own_listed_number_required" | "cli_must_be_presented" | "none_found";
+                penalties: string;
+                /** @description Automated marketing calls are a prohibited class here regardless of consent. */
+                prohibited: boolean;
+                links: {
+                    name: string;
+                    url: string;
+                }[];
+                last_reviewed: string;
+            }[];
+        };
         LaunchPreviewDto: {
             /** @description A FORECAST of how many would start sending, not a promise: consent and suppression are re-checked at claim time and fail closed. */
             will_send: number;
@@ -10303,6 +10417,8 @@ export interface components {
                 language: string;
                 status: string;
             }[];
+            /** @description Informational: present when the campaign has voice steps reaching a catalogued country. Show it before launching and pass regulatory_acknowledged: true when the user confirms — the launch itself never refuses over it. Null: nothing to show. */
+            regulatory_notice: components["schemas"]["SequenceRegulatoryNoticeDto"] | null;
         };
         SequenceSendersDto: {
             senders: {
@@ -11560,6 +11676,10 @@ export interface components {
                                     id: string;
                                     name: string;
                                 }[];
+                                /** @default null */
+                                pacing_until: string | null;
+                                /** @default null */
+                                skip_reason: "pacing" | null;
                             } | null;
                             peers: {
                                 agent_id: number;
@@ -11577,6 +11697,10 @@ export interface components {
                                     id: string;
                                     name: string;
                                 }[];
+                                /** @default null */
+                                pacing_until: string | null;
+                                /** @default null */
+                                skip_reason: "pacing" | null;
                             }[];
                             /** @default [] */
                             required_skills: {
@@ -11913,6 +12037,28 @@ export interface components {
                 };
             };
         };
+        ChatSessionFollowUpOutput: {
+            /** @description Follow-up id — stable across the follow-up’s lifetime */
+            id: string;
+            session_id: string;
+            ticket_number: number;
+            prompt: string;
+            /**
+             * Format: date-time
+             * @description When the follow-up fires (UTC)
+             */
+            fire_at: string;
+            is_active: boolean;
+            /** Format: date-time */
+            created_at: string;
+        };
+        ChatSessionFollowUpListOutput: {
+            follow_ups: components["schemas"]["ChatSessionFollowUpOutput"][];
+            limits: {
+                max_active_per_session: number;
+                max_total_per_session: number;
+            };
+        };
         ContactSegment: {
             id: string;
             name: string;
@@ -12159,11 +12305,6 @@ export interface components {
                 channel: string;
                 /** @description Whether the AI autopilot is enabled on this channel */
                 autopilot_enabled: boolean;
-                /**
-                 * @description AI agent version used on this channel
-                 * @enum {string}
-                 */
-                ai_agent_version: "v1" | "v2";
             }[];
         };
         ProhibitedTopicsResponseDto: {
@@ -14618,6 +14759,108 @@ export interface operations {
             };
         };
     };
+    listChatSessionFollowUps: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The unique identifier of the chat session */
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionFollowUpListOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    createChatSessionFollowUp: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The unique identifier of the chat session */
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateChatSessionFollowUpInput"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionFollowUpOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    cancelChatSessionFollowUp: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The unique identifier of the chat session */
+                session_id: string;
+                /** @description The follow-up id returned when it was scheduled */
+                follow_up_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionFollowUpOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     listCompanies: {
         parameters: {
             query?: {
@@ -20576,7 +20819,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LaunchSequenceInputDto"] | null;
+            };
+        };
         responses: {
             /** @description Default Response */
             201: {