@opencx/mcp 1.15.26 → 1.15.28

package/dist/tools/skills.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { jsonContent } from '../api-client.js';
+const ROUTING_NOTE = 'Skills drive skills-based routing: a session carries required skills (set only by the "Assign Skills to Ticket" workflow action — there is no tool to set them directly), and when "Assign Ticket to Support Team" / "Auto Assign to Support Team" runs with skill-based routing enabled, only team members holding every required skill are eligible. Load the "skills-routing" skill for the full setup.';
+const skillDescriptionField = z
+    .string()
+    .nullable()
+    .optional()
+    .describe('What the skill covers, written as the condition under which a session needs it (e.g. "Billing disputes, refunds, invoice questions"). AI workflow steps read this via {{routingSkills}} to decide which skills to put on a session, so keep it concrete.');
+export function registerSkillTools(server, client) {
+    server.registerTool('list_skills', {
+        description: `List every routing skill defined for the organization, newest first. ${ROUTING_NOTE}`,
+    }, async () => {
+        const data = (await client.GET('/skills')).data;
+        return jsonContent(data);
+    });
+    server.registerTool('get_skill', {
+        description: 'Get a single routing skill by ID.',
+        inputSchema: {
+            skill_id: z.string().uuid().describe('Skill ID'),
+        },
+    }, async ({ skill_id }) => {
+        const data = (await client.GET('/skills/{skill_id}', { params: { path: { skill_id } } }))
+            .data;
+        return jsonContent(data);
+    });
+    server.registerTool('create_skill', {
+        description: `Create a routing skill. Names are unique per organization (case-insensitive). Always provide a description — it is what the AI reads when deciding which skills a session needs. ${ROUTING_NOTE}`,
+        inputSchema: {
+            name: z.string().min(1).describe('Skill name (e.g. "billing", "spanish", "enterprise")'),
+            description: skillDescriptionField,
+        },
+    }, async (body) => {
+        const data = (await client.POST('/skills', { body })).data;
+        return jsonContent(data);
+    });
+    server.registerTool('update_skill', {
+        description: 'Rename a routing skill and/or change its description. Only provided fields change. Renaming is safe: agents and sessions reference skills by ID.',
+        inputSchema: {
+            skill_id: z.string().uuid().describe('Skill ID'),
+            name: z.string().min(1).optional().describe('New skill name'),
+            description: skillDescriptionField,
+        },
+    }, async ({ skill_id, ...body }) => {
+        const data = (await client.PATCH('/skills/{skill_id}', { params: { path: { skill_id } }, body })).data;
+        return jsonContent(data);
+    });
+    server.registerTool('delete_skill', {
+        description: 'Delete a routing skill. Agents that held it and sessions that required it simply stop referencing it. Confirm with the user first — a deleted skill silently loosens routing for every session that required it.',
+        inputSchema: {
+            skill_id: z.string().uuid().describe('Skill ID'),
+        },
+    }, async ({ skill_id }) => {
+        await client.DELETE('/skills/{skill_id}', { params: { path: { skill_id } } });
+        return jsonContent({ success: true, skill_id });
+    });
+    server.registerTool('get_user_skills', {
+        description: 'List the routing skills an organization member (agent) holds. Use list_org_users to find the user ID.',
+        inputSchema: {
+            user_id: z.number().int().positive().describe('Organization user ID'),
+        },
+    }, async ({ user_id }) => {
+        const data = (await client.GET('/skills/users/{user_id}', { params: { path: { user_id } } }))
+            .data;
+        return jsonContent(data);
+    });
+    server.registerTool('set_user_skills', {
+        description: 'Replace the full set of routing skills an organization member (agent) holds. Skills not in skill_ids are REMOVED — call get_user_skills first and merge when adding. Every ID must be a skill of this organization. Returns the resolved skills now assigned.',
+        inputSchema: {
+            user_id: z.number().int().positive().describe('Organization user ID'),
+            skill_ids: z.array(z.string().uuid()).describe('The complete set of skill IDs to hold'),
+        },
+    }, async ({ user_id, skill_ids }) => {
+        const data = (await client.PUT('/skills/users/{user_id}', {
+            params: { path: { user_id } },
+            body: { skill_ids },
+        })).data;
+        return jsonContent(data);
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/tools/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/tools/skills.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,YAAY,GAChB,4YAA4Y,CAAC;AAE/Y,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,EAAE;KACV,QAAQ,CACP,0PAA0P,CAC3P,CAAC;AAEJ,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAoB;IACxE,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EAAE,wEAAwE,YAAY,EAAE;KACpG,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EAAE,mCAAmC;QAChD,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;SACjD;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;aACtF,IAAI,CAAC;QACR,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE,oLAAoL,YAAY,EAAE;QAC/M,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YACxF,WAAW,EAAE,qBAAqB;SACnC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,kJAAkJ;QACpJ,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC7D,WAAW,EAAE,qBAAqB;SACnC;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,CACX,MAAM,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CACnF,CAAC,IAAI,CAAC;QACP,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,kNAAkN;QACpN,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;SACjD;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9E,OAAO,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,uGAAuG;QACzG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;SACtE;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;aAC1F,IAAI,CAAC;QACR,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,+PAA+P;QACjQ,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACrE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACxF;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,CACX,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,EAAE;YAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE;YAC7B,IAAI,EAAE,EAAE,SAAS,EAAE;SACpB,CAAC,CACH,CAAC,IAAI,CAAC;QACP,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencx/mcp",
-  "version": "1.15.26",
+  "version": "1.15.28",
   "private": false,
   "description": "MCP server for OpenCX — manage contacts, sessions, training, and more from Claude Desktop, Cursor, or any MCP client.",
   "type": "module",