@opencx/mcp 1.11.86 → 1.11.87

package/dist/invoke-action.spec.d.ts

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

package/dist/invoke-action.spec.d.ts.map

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

package/dist/invoke-action.spec.js

@@ -0,0 +1,68 @@
+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;
+}
+describe('invoke_action 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('accepts numeric/boolean query and path params and forwards them (no client-side string-only rejection)', async () => {
+        fetchSpy.mockResolvedValueOnce(mockResponse({ status: 200, body: { ok: true } }));
+        const result = await client.callTool({
+            name: 'invoke_action',
+            arguments: {
+                operation_id: 'getThing',
+                inputs: { pathParams: { id: 7 }, queryParams: { limit: 42, active: true } },
+            },
+        });
+        expect(result.isError).toBeFalsy();
+        const call = fetchSpy.mock.calls[0];
+        expect(getRequestUrl(call)).toContain('/actions/getThing/invoke');
+        expect(getRequestMethod(call)).toBe('POST');
+        // The non-string values pass the tool schema and reach the API as JSON
+        // (the backend coerces them on the wire, like the agent).
+        expect(await getRequestBody(call)).toEqual({
+            inputs: { pathParams: { id: 7 }, queryParams: { limit: 42, active: true } },
+        });
+    });
+});
+//# sourceMappingURL=invoke-action.spec.js.map

package/dist/invoke-action.spec.js.map

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

package/dist/schema.d.ts

@@ -75,6 +75,26 @@ export interface paths {
         patch: operations["updateAction"];
         trace?: never;
     };
+    "/actions/{operation_id}/invoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Invoke an action
+         * @description Run a configured action the same way the AI agent runs it in a conversation — make the action’s configured HTTP request and return the upstream status and body. Addressed by operation_id (the handle the agent uses). The target URL comes only from the action configuration, never the request. With `context.sessionId`, the request is decorated with the same in-session context the agent attaches (org globals, contact identity, default headers, and — off web — per-contact backend auth), so a caller embedded in a conversation invokes the action with the agent’s context; without it, only org globals apply. Actions requiring a form still execute — supplying the inputs is the submission.
+         */
+        post: operations["invokeAction"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/actions/all": {
         parameters: {
             query?: never;
@@ -1772,6 +1792,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workflows/{workflow_id}/invoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * [Beta] Invoke a workflow
+         * @description Run a workflow the same way the AI agent runs one during a conversation. Handles the on-demand trigger types the agent can invoke — ai-trigger, manual-ticket-trigger, and manual-trigger — and rejects event-only workflows. `input` is the payload: the ai payload for ai-trigger, the form data for manual-ticket-trigger (manual-trigger takes none). With `context.sessionId`, the workflow runs with the same in-session ticket context the agent has (required for manual-ticket-trigger). This exposes, to a caller embedded in a conversation, the same workflows the agent can trigger in that session. Returns the run id, plus the terminal output when the workflow runs synchronously.
+         */
+        post: operations["invokeWorkflow"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workflows/{workflow_id}/runs": {
         parameters: {
             query?: never;
@@ -2156,6 +2196,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/resource-usage/{resource_type}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List usage counts for all resources of a type
+         * @description Bulk usage: one row per action, instruction, or KB item in the org, with available / applied (used) counts, the handoff count, and first/last-used timestamps — most recently used first. The per-item alternative to calling `usage-summary` once per id. Paginated via the opaque `cursor`; optionally bound by a date range.
+         */
+        get: operations["listResourceUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/sequences": {
         parameters: {
             query?: never;
@@ -4323,6 +4383,28 @@ export interface components {
             /** @description Require the user to submit a form before executing */
             require_form_submission?: boolean;
         };
+        InvokeActionDto: {
+            /**
+             * @description Inputs forwarded to the action’s HTTP request
+             * @default {}
+             */
+            inputs: {
+                /** @description Query string params */
+                queryParams?: {
+                    [key: string]: unknown;
+                };
+                /** @description Path template params */
+                pathParams?: {
+                    [key: string]: unknown;
+                };
+                /** @description Request body (sent for non-GET methods) */
+                body?: unknown;
+            };
+            context?: {
+                /** @description Optional conversation session. When given, the request is decorated with the same in-session context the AI agent attaches (org globals, contact identity, default headers, and — off web — per-contact backend auth). */
+                sessionId?: string;
+            };
+        };
         UpdateAutopilotInputDto: {
             /**
              * @description Channel to update: web, email, phone, whatsapp, slack, sms, instagram, messenger, api, web_voice
@@ -5106,6 +5188,19 @@ export interface components {
             /** @description New description for the category */
             description?: string;
         };
+        InvokeWorkflowDto: {
+            /**
+             * @description Inputs for the workflow (ai payload / form data)
+             * @default {}
+             */
+            input: {
+                [key: string]: unknown;
+            };
+            context?: {
+                /** @description Conversation session for ticket context */
+                sessionId?: string;
+            };
+        };
         SearchTrainingKnowledgeInputDto: {
             query: string;
             /** @default 10 */
@@ -5415,6 +5510,9 @@ export interface components {
                         name: string;
                     }[];
                 } | null;
+                custom_data?: {
+                    [key: string]: unknown;
+                } | null;
             } | {
                 actionCalls?: {
                     action: {
@@ -5454,6 +5552,9 @@ export interface components {
                 additional_debug_data?: {
                     [key: string]: unknown;
                 } | null;
+                custom_data?: {
+                    [key: string]: unknown;
+                } | null;
                 whatsapp_template_request?: unknown | null;
                 rule_violation_reflections?: {
                     rule_name: string;
@@ -5773,7 +5874,7 @@ export interface components {
             nodes: {
                 id: string;
                 /** @enum {string} */
-                dimensionKey: "replied_by" | "outcome" | "handoff" | "channel" | "integration_source" | "assist_mode" | "contact_custom_data" | "sentiment" | "status" | "assigned_team" | "contact_source";
+                dimensionKey: "all_tickets" | "replied_by" | "outcome" | "handoff" | "channel" | "integration_source" | "assist_mode" | "contact_custom_data" | "session_custom_data" | "sentiment" | "status" | "assigned_team" | "contact_source";
                 dimensionLabel: string;
                 bucket: string;
                 count: number;
@@ -6276,6 +6377,12 @@ export interface components {
              */
             updated_at: string;
         };
+        InvokeActionResponseDto: {
+            /** @description Upstream HTTP status code */
+            status: number;
+            /** @description Parsed JSON when the response is JSON, else the raw text */
+            body: unknown;
+        };
         AutopilotStatusResponseDto: {
             channels: {
                 /** @description Channel name */
@@ -6585,6 +6692,9 @@ export interface components {
                         additional_debug_data?: {
                             [key: string]: unknown;
                         } | null;
+                        custom_data?: {
+                            [key: string]: unknown;
+                        } | null;
                         whatsapp_template_request?: unknown | null;
                         rule_violation_reflections?: {
                             rule_name: string;
@@ -7279,6 +7389,27 @@ export interface components {
             /** @description ISO 8601 timestamp of most recent use */
             last_used_at: string | null;
         };
+        PublicResourceUsageListDto: {
+            items: {
+                resource_id: string;
+                /** @description Distinct conversations that used this resource (usage mirror ∪ handoff citations) */
+                session_count: number;
+                /** @description Distinct conversations where the resource was applied */
+                applied_sessions: number;
+                /** @description Total applications/invocations */
+                applied_replies: number;
+                /** @description Distinct conversations where an instruction was in context (instructions only) */
+                available_sessions: number;
+                available_replies: number;
+                /** @description Distinct conversations that handed off while citing this resource (0 for actions) */
+                handoff_count: number;
+                /** @description ISO 8601 timestamp of first use */
+                first_used_at: string | null;
+                /** @description ISO 8601 timestamp of most recent use */
+                last_used_at: string | null;
+            }[];
+            next: string | null;
+        };
         AddContactsToSequenceOutput: {
             run_id: string;
         };
@@ -7875,6 +8006,17 @@ export interface components {
         DeactivateWorkflowOutput: {
             success: boolean;
         };
+        InvokeWorkflowResponseDto: {
+            /** @description The id of the workflow run */
+            run_id: string;
+            /**
+             * @description completed = ran synchronously; queued = running in the background
+             * @enum {string}
+             */
+            status: "completed" | "queued";
+            /** @description Terminal output, present when the workflow ran synchronously */
+            output?: unknown;
+        };
         ListWorkflowRunsOutput: {
             runs: components["schemas"]["WorkflowRunPublicResponseDto"][];
             total_items: number;
@@ -8159,6 +8301,41 @@ export interface operations {
             };
         };
     };
+    invokeAction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                operation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvokeActionDto"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvokeActionResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     deleteAllActions: {
         parameters: {
             query?: never;
@@ -10869,7 +11046,7 @@ export interface operations {
             query: {
                 /** @description Comma-separated dimension keys, e.g. "replied_by,outcome". 1–6 allowed. */
                 dimensions: string;
-                /** @description Contact custom_data key to read when the contact_custom_data dimension is used. */
+                /** @description The jsonb key to read for a custom-data dimension (contact_custom_data or session_custom_data). */
                 custom_data_key?: string;
                 /** @description Start date in ISO 8601 format (defaults to 30 days ago) */
                 start_date?: string;
@@ -11734,6 +11911,42 @@ export interface operations {
             };
         };
     };
+    invokeWorkflow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The workflow UUID to invoke */
+                workflow_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvokeWorkflowDto"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvokeWorkflowResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     listWorkflowRuns: {
         parameters: {
             query?: {
@@ -12550,6 +12763,44 @@ export interface operations {
             };
         };
     };
+    listResourceUsage: {
+        parameters: {
+            query?: {
+                from?: unknown;
+                to?: unknown;
+                /** @description Opaque pagination cursor from a previous `next` */
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description The kind of AI resource to look up: `action` (a tool the AI can call), `instruction` (an AI instruction/behavior), or `knowledge` (a knowledge base item). */
+                resource_type: "action" | "instruction" | "knowledge";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PublicResourceUsageListDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     createSequence: {
         parameters: {
             query?: never;